---
title: "POST /v1/fraud/scores"
method: POST
path: "/v1/fraud/scores"
---

# POST /v1/fraud/scores

`POST /v1/fraud/scores`

## Request

- Base URL: ` https://api.paymongo.com` (relative, and the document’s source URL is not known)
- URL: ` https://api.paymongo.com/v1/fraud/scores`
- Auth: HTTP basic

## Request body

- object
  - `external_id` string, required: Unique reference for the transaction in your system
  - `external_attribute_name` string, required: The name/type of the external ID (e.g., `order_id`, `invoice_id`, etc.)
  - `payment_method` 'credit_card', required: Payment method used in the transaction. Valid values "credit_card". Support for additional payment methods is coming soon.
  - `variables` object, required: Details of the transaction
    - `amount` number, required: The total amount of the transaction
    - `billing_address_1` string: The primary line of the customer's billing address
    - `billing_address_city` string: The city from the customer's billing address
    - `billing_address_country` string: The country code for the customer's billing address, e.g. "PH", "SG", etc.
    - `billing_address_phone` string: The phone number associated with the customer's billing address.
    - `billing_address_zipcode` string: The postal or ZIP code from the customer's billing address.
    - `creditcard_country` string, required: The country code (ISO 3166-1 alpha-2) for the credit card's issuing country. (Only for "credit_card" payment method)
    - `creditcard_bin` string, required: The Bank Identification Number (first 6 digits) of the credit card. (Only for "credit_card" payment method)
    - `creditcard_last4` string, required: The last four digits of the credit card number. (Only for "credit_card" payment method)
    - `customer_name` string: The full name of the customer making the transaction.
    - `customer_email` string: The email address of the customer making the transaction.

## Response `200`

OK

---

[API](https://skmtc.dev/paymongo/apis/fraud-prevention.md) - [All operations](https://skmtc.dev/paymongo/apis/fraud-prevention/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/fraud-prevention/revisions/78ba86eb7198?raw)
