Reconciliation

The following part of the SolidGate documentation contains notes to the Reconciliation service. 
It allows you to get all orders or chargebacks for you account for a certain period. 
Methods that can be used:

  • orders reconciliation
  • chargebacks reconciliation

Order Reconciliation

All request must be signed.

POST https://reports.solidgate.com/api/v2/reconciliation/orders

Request parameters
 

ParameterMandatoryTypeDescriptionValue sample
date_fromYesStringStart date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-07 11:00:00
date_toYesStringEnd date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-14 13:00:00
next_page_iteratorNoStringIf it is necessary to perform a pagination in the request body, add the field with the value from the previous response.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

The limit in search is 2000 of all updated entities. If in a given on request time interval, the number of entities is more than 2000, then a unique hash `next_page_iterator` will be returned in the response. 

If this field equals null, then all data has been returned on response.

If this field is not null, then merchants need to make a new request with adding parameter `next_page_iterator`.

Request parameters

ParameterMandatoryTypeDescriptionValue sample
date_fromYesStringStart date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-07 11:00:00
date_toYesStringEnd date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-14 13:00:00
next_page_iteratorNoStringIf it is necessary to perform a pagination in the request body, add the field with the value from the previous response.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

Request sample

{
  "date_from": "2017-07-07 11:00:00",
  "date_to": "2017-07-14 13:00:00",
  "next_page_iterator": "7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8="
}

Parameters of the successful response

ParameterTypeDescriptionValue sample
ordersListList of orders 
orders:order_idStringOrder ID1564478491360abc
orders:statusStringStatus of processed payment. Types of statuses are described in the respective directoryapproved
orders:typeStringType of operation. Types of order status are described in the respective directoryrecurring
orders:amountIntegerOrder amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents2575
orders:currencyStringOrder currency (3 letter code under ISO 4217)USD
orders:order_descriptionStringOrder description in UTF-8Premium package
orders:customer_account_idStringcustomer account ID on merchant site4dad42f808
orders:customer_emailStringCustomer emailtest@testmail.com
orders:customer_first_nameStringCustomer's first nameJohn
orders:customer_last_nameStringCustomer last nameSnow
orders:geo_countryStringCustomer country. The code shall have the format ISO 3166-1 alpha-3GBR
orders:ip_addressStringCustomer IP (only the public one)8.8.8.8
orders:error_codeStringError code. Error codes list3.02
orders:platformStringCustomer platform at the moment of payment. Available values: WEB - desktop, MOB - mobile version, APP - applicationWEB
orders:fraudulentBooleanThe customer was detected on the merchant end to be the suspicious oneTRUE
orders:is_securedBooleanThe attribute shows that the payment goes through 3DS-verificationFALSE
orders:created_atStringDate and time of order creation2017-07-07 11:00:15
orders:updated_atStringDate and time of order update2017-07-10 10:30:54
orders:transactionsListList of order transactions 
orders:transactions:idStringTransaction ID245f6ehky4554
orders:transactions:operationStringType of operationrecurring
orders:transactions:statusStringTransaction statussuccess
orders:transactions:descriptorStringDescriptor of order transaction (how it looks in the Bank statement)FAKE_PSP
orders:transactions:amountIntegerTransaction amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents100
orders:transactions:currencyStringTransaction currency (3 letter code under ISO 4217)USD
orders:transactions:refund_reasonStringRefund reason for the transactionSome Reason
orders:transactions:refund_reason_codeStringCode of refund reason19
orders:transactions:created_atStringDate and time of transaction creation2019-07-09 10:30:54
orders:transactions:updated_atStringDate and time of transaction update2019-07-10 10:30:54
orders:transactions:finance_fee_amountIntegerFee amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents100
orders:transactions:finance_fee_currencyStringFee currency (3 letter code under ISO 4217)USD
orders:transactions:cardObjectThe object of the card information 
orders:transactions:card:bankStringA bankThe unique that issues the cardSTATE BANK
orders:transactions:card:binStringFirst 6 digits of the card number411111
orders:transactions:card:card_holderStringCardholder nameJohn Snow
orders:transactions:card:brandStringCard BrandVISA
orders:transactions:card:countryStringCountry of bankUSA
orders:transactions:card:numberStringCard number4111111111111111
orders:transactions:card:card_exp_yearIntegerYear of card expiration (4-digit format)2021
orders:transactions:card:card_exp_monthStringThe month of card expiration (2-digit format)2
orders:transactions:card:card_typeStringType of the payment cardDEBIT
orders:transactions:finance_fee_amountIntegerFee amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 centsUSA
orders:transactions:finance_fee_currencyStringFee currency (3 letter code under ISO 4217)USD
orders:transactions:billing_detailsobjectBilling Details 
orders:transactions:billing_details:addresstringAddress of the billing8th Ave, Bowie Lane
orders:transactions:billing_details:zipstringZIP for the billing10001
orders:transactions:billing_details:countrystringCountry of the billingUSA
orders:transactions:billing_details:citystringCity of the billingNew York
orders:billing_details:statestringState of the billingFL
metadataObject  
metadata:next_page_iteratorStringUnique hash for receiving new data. If it's null - all data was successfully getting by the merchant7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=
    

Example of a successful response

{
  "orders": [
    {
      "order_id": "1564478491360recurring",
      "status": "refunded",
      "type": "recurring",
      "amount": 5200,
      "currency": "USD",
      "order_description": "test",
      "customer_account_id": "1234567",
      "customer_email": "kurt.Cruickshank.toster@gmail.com",
      "customer_first_name": null,
      "customer_last_name": null,
      "geo_country": "USA",
      "ip_address": "8.8.8.8",
      "error_code": null,
      "platform": "WEB",
      "fraudulent": true,
      "is_secured": false,
      "created_at": "2019-07-30 09:21:31",
      "updated_at": "2019-07-31 08:14:13",
      "transactions": [
        {
          "id": "748b3f9eb69c6f6ac3be9102ba5a52cd5d414dd55cafb",
          "operation": "refund",
          "status": "success",
          "descriptor": "FAKE_PSP",
          "amount": 5200,
          "currency": "USD",
          "refund_reason": null,
          "refund_reason_code": "0019",
          "created_at": "2019-07-31 08:14:13",
          "updated_at": "2019-07-31 08:14:13",
          "finance_fee_amount": 15,
          "finance_fee_currency": USD,
          "card": {
            "bank": null,
            "bin": null,
            "card_holder": null,
            "brand": null,
            "country": null,
            "number": null,
            "card_exp_month": null,
            "card_exp_year": null,
            "card_type": null
          }
        },
        {
          "id": "748b3f9eb69c6f6ac3be9102ba5a52cd5d400c1be0638",
          "operation": "recurring",
          "status": "success",
          "descriptor": "FAKE_PSP",
          "amount": 5200,
          "currency": "USD",
          "refund_reason": null,
          "refund_reason_code": null,
          "created_at": "2019-07-30 09:21:31",
          "updated_at": "2019-07-30 09:21:33",
          "finance_fee_amount": 10,
          "finance_fee_currency": USD,
          "card": {
            "bank": null,
            "bin": "471688",
            "card_holder": "diana goodman",
            "brand": "VISA",
            "country": "TUR",
            "number": "471688XXXXXX3303",
            "card_exp_month": "08",
            "card_exp_year": 2022,
            "card_type": "DEBIT"
          },
          "billing_details": {
            "address": "11437 Woodmeadow Pkwy",
            "zip": "85001",
            "country": "USA",
            "city": "New Delhi",
            "state": "TX"
        }
      ]
    }
  ],
  "metadata": {
    "next_page_iterator": null
  }
}

Chargeback Reconciliation

All request must be signed.

POST https://reports.solidgate.com/api/v2/reconciliation/chargebacks

The limit in search is 2000 of all updated entities. If in a given on request time interval, the number of entities is more than 2000, then a unique hash `next_page_iterator` will be returned in the response. 

If this field equals null, then all data has been returned on response.

If this field is not null, then merchants need to make a new request with adding parameter `next_page_iterator`.

Request parameters
 

ParameterMandatoryTypeDescriptionValue sample
date_fromYesStringStart date and time of chargebacks or chargebacks flow creating. Format "Y-m-d H:i:s"2019-07-07 11:00:00
date_toYesStringEnd date and time of chargebacks or chargebacks flow creating. Format "Y-m-d H:i:s"2019-07-14 13:00:00
next_page_iteratorNoStringIf it is necessary to perform a pagination in the request body, add the field with the value from the previous response.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

Request sample

{
  "date_from": "2017-07-07 11:00:00",
  "date_to": "2017-07-14 13:00:00",
  "next_page_iterator": "7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8="
}

Parameters of the successful response

ParameterTypeDescriptionValue sample
ordersListList of orders with chargeback 
orders:order_idStringOrder ID1564478491360abc
orders:statusStringStatus of processed payment. Types of statuses are described in the respective directory.approved
orders:typeStringType of operation. Types of order status are described in the respective directory.recurring
orders:amountIntegerOrder amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.2575
orders:currencyStringOrder currency (3 letter code under ISO 4217)USD
orders:order_descriptionStringOrder description in UTF-8Premium package
orders:customer_account_idStringcustomer account ID on merchant site4dad42f808
orders:customer_emailStringCustomer emailtest@testmail.com
orders:customer_first_nameStringCustomer's first nameJohn
orders:customer_last_nameStringCustomer last nameSnow
orders:geo_countryStringCustomer country. The code shall have the format ISO 3166-1 alpha-3GBR
orders:ip_addressStringCustomer IP (only the public one).8.8.8.8
orders:error_codeStringError code. Error codes list.3.02
orders:platformStringCustomer platform at the moment of payment. Available values: WEB - desktop, MOB - mobile version, APP - applicationWEB
orders:fraudulentBooleanThe customer was detected on the merchant end to be the suspicious oneTRUE
orders:is_securedBooleanThe attribute shows that the payment goes through 3DS-verification.FALSE
orders:created_atStringDate and time of order creation2017-07-07 11:00:15
orders:updated_atStringDate and time of order update2017-07-10 10:30:54
orders:chargebacksListList of orders chargeback 
orders:chargebacks:idStringChargeback ID148812
orders:chargebacks:created_atStringDate and time of chargeback creation2019-07-12 10:50:25
orders:chargebacks:dispute_dateStringChargeback dispute date2019-07-12 10:50:25
orders:chargebacks:settlement_dateStringChargeback settlement date2019-07-12 10:50:25
orders:chargebacks:statusStringChargeback statusin_progress
orders:chargebacks:typeStringType of chargeback1st_chb
orders:chargebacks:amountIntegerChargeback amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.90
orders:chargebacks:currencyStringTransaction currency (3 letter code under ISO 4217)USD
orders:chargebacks:reason_groupStringGroup of chargeback reasonFraud
orders:chargebacks:reason_codeStringCode of chargeback reason10.4
orders:chargebacks:reason_descriptionStringDescription of chargeback reasonFraud – Card-Absent Environment
orders:chargebacks:finance_fee_amountIntegerFee amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.100
orders:chargebacks:finance_fee_currencyStringFee currency (3 letter code under ISO 4217)USD
orders:chargebacks:flowsObjectObject of the card information 
orders:chargebacks:flows:idStringID of chargeback flow12345
orders:chargebacks:flows:amountIntegerChargeback flow amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.50
orders:chargebacks:flows:dispute_amountIntegerChargeback flow dispute amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.20
orders:chargebacks:flows:typeStringType of chargeback1st_chb
orders:chargebacks:flows:statusStringChargeback statusin_progress
orders:chargebacks:flows:dateStringChargeback flow date2019-07-10
orders:chargebacks:flows:settlement_dateStringChargeback flow settlement date2019-07-11
orders:chargebacks:flows:created_atStringChargeback flow created date and time2019-07-12 10:50:25
orders:chargebacks:flows:updated_atStringChargeback flow updated date and time2019-07-12 10:50:25
orders:chargebacks:flows:deadline_dateStringChargeback deadline date2019-07-15
orders:chargebacks:flows:arn_codeStringARN code24021219179008444371917
orders:chargebacks:flows:currencyStringTransaction currency (3 letter code under ISO 4217)USD
orders:chargebacks:flows:finance_fee_amountIntegerFee amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.10
orders:chargebacks:flows:finance_fee_currencyStringFee currency (3 letter code under ISO 4217)USD
metadataObject  
metadata:next_page_iteratorStringUnique hash for receiving new data. If it's null - all data was successfully getting by the merchant.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

Example of a successful response

{
  "orders": [
    {
      "order_id": "267715846",
      "status": "approved",
      "type": "recurring",
      "amount": 690,
      "currency": "USD",
      "order_description": "VIP status",
      "customer_account_id": "76315607",
      "customer_email": "martin10_06@gmail.com",
      "customer_first_name": "Alexander",
      "customer_last_name": null,
      "geo_country": "PER",
      "ip_address": "132.191.0.111",
      "error_code": null,
      "platform": "WEB",
      "fraudulent": false,
      "is_secured": false,
      "created_at": "2019-06-28 12:28:03",
      "updated_at": "2019-06-28 12:28:05",
      "chargebacks": [
        {
          "id": "148812",
          "created_at": "2019-07-12 10:50:25",
          "dispute_date": "2019-07-10",
          "settlement_date": "2019-07-10",
          "amount": 690,
          "reason_code": "10.4",
          "type": "1st_chb",
          "status": "in_progress",
          "reason_group": "Fraud",
          "reason_description": "Fraud – Card-Absent Environment",
          "currency": "USD",
          "finance_fee_amount": null,
          "finance_fee_currency": null,
          "flows": [
            {
              "id": "414610",
              "amount": 690,
              "dispute_amount": null,
              "type": "1st_chb",
              "status": "in_progress",
              "date": "2019-07-10",
              "settlement_date": "2019-07-11",
              "created_at": "2019-07-12 10:50:25",
              "updated_at": "2019-07-12 10:50:25",
              "deadline_date": "2019-07-22",
              "arn_code": "24021219179008444371917",
              "currency": "USD",
              "finance_fee_amount": null,
              "finance_fee_currency": null
            }
          ]
        }
      ]
    }
  ],
  "metadata": {
    "next_page_iterator": null
  }
}

Alt-Gate Order Reconciliation

All request must be signed.

POST https://reconciliation-alt.solidgate.com/api/v1/reconciliation/orders

The limit in search is 2000 of all updated entities. If in a given on request time interval, the number of entities is more than 2000, then a unique hash `next_page_iterator` will be returned in the response. 

If this field equals null, then all data has been returned on response.

If this field is not null, then merchants need to make a new request with adding parameter `next_page_iterator`.

Request parameters

ParameterMandatoryTypeDescriptionValue sample
date_fromYesStringStart date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-07 11:00:00
date_toYesStringEnd date and time of orders and transactions creating. Format "Y-m-d H:i:s"2019-07-14 13:00:00
next_page_iteratorNoStringIf it is necessary to perform pagination in the request body, add the field with the value from the previous response.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

Request sample

{
  "date_from": "2017-07-07 11:00:00",
  "date_to": "2017-07-14 13:00:00",
  "next_page_iterator": "7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8="
}

Parameters of the successful response for PayPal

ParameterTypeDescriptionValue sample
ordersListList of orders 
orders:order_idStringOrder ID360359
orders:amountIntegerOrder amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents2575
orders:currencyStringOrder currency (3 letter code under ISO 4217)USD
orders:statusStringStatus of processed payment. Types of statuses are described in the respective directoryapproved
orders:methodStringThe method used for paymentpaypal
orders:created_atStringWhen the order was created2020-07-02 23:39:06
orders:updated_atStringThe last time the order was updated2020-07-08 1:40:44
orders:customer_emailStringEmail of the customertest@gmail.com
orders:ip_addressStringIP of the customer70.65.246.237
orders:transactionsString  
orders:transactions:statusStringStatus of the transactionprocessing
orders:transactions:methodStringThe method used for paymentpaypal
orders:transactions:amountIntegerAmount of funds in the transaction249
orders:transactions:currencyStringCurrency used for the transactionUSD
orders:transactions:typeStringType of the transactionsrecurring
orders:order_descriptionStringOrder description in UTF-8Premium package
orders:customer_account_idStringCustomer account ID on merchant site4dad42f808
orders:processing_amountIntegerAmount of funds in the transaction249
orders:processing_currencyCurrencyCurrency used for the transactionUSD
metadataObject  
metadata:next_page_iteratorStringUnique hash for receiving new data. If it's null - all data was successfully getting by the merchant7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

A merchant could receive information about Fraud Alerts in two ways: by callback and by reconciliation API.

Using reconciliation API, Fraud Alerts could be downloaded within the specified period (per hour basis).
The response body is limited by 10 000 records. If there are more than 10 000 records, you should provide the `next_page_iterator` param in the request body to retrieve the following data.

All request must be signed.

Example of a successful response

{
  "orders": [
    {
      "order_id": "1547088796",
      "amount": 599900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 599900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 599900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1547088797",
      "amount": 599900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 599900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 599900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1547088798",
      "amount": 599900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 599900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 599900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1547607507",
      "amount": 5399900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 5399900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 5399900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1548038304",
      "amount": 3599900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 3599900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 3599900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1548212497",
      "amount": 599900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 599900,
          "currency": "USD",
          "type": "pay"
        }
      ],
      "processing_amount": 599900,
      "processing_currency": "USD"
    },
    {
      "order_id": "1548643149",
      "amount": 4999900,
      "currency": "USD",
      "status": "approved",
      "method": "solid-cards",
      "created_at": "2020-07-02 23:39:06",
      "updated_at": "2020-07-08 01:40:44",
      "customer_email": "test@gmail.com",
      "ip_address": "8.8.8.8",
      "transactions": [
        {
          "status": "success",
          "method": "solid-cards",
          "amount": 4999900,
          "currency": "USD",
          "type": "recurring"
        }
      ],
      "processing_amount": 4999900,
      "processing_currency": "USD"
    }
  ],
  "metadata": {
    "next_page_iterator": null
  }
}

Fraud Alerts Reconciliation

POST https://reports.signedpay.com/api/v2/reconciliation/fraud-alerts

Request parameters

ParameterMandatoryTypeDescriptionValue sample
date_fromYesStringStart date and time of orders download. Format "Y-m-d H:i:s"2017-07-07 11:00:00
date_toYesStringEnd date and time of orders download. Format "Y-m-d H:i:s"2017-07-14 13:00:00
formatYesStringThe data format of download. Currently available: JSON.json
next_page_iteratorNoStringIf it is necessary to perform a pagination in the request body, add the field with the value from the previous response.7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8=

Request sample

{
  "date_from": "2017-07-07 11:00:00",
  "date_to": "2017-07-14 13:00:00",
  "format": "json"
  "next_page_iterator": "7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3+34Xw8="
}

Parameters of the successful response

ParameterTypeDescriptionValue sample 
alertsListList of alerts  
alerts:order_idStringOrder ID777 
alerts:created_atStringDate and time of order creation2017-07-07 11:00:15 
alerts:fraud_amountIntegerFraud order amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.2575 
alerts:fraud_currencyStringFraud order currency (3 letter code under ISO 4217)USD 
alerts:fraud_amount_usdIntegerFraud order amount in USD12367 
alerts:fraud_typeIntegerType of fraudulent6 
alerts:card_schemeStringCard SchemeVISA 
alerts:fraud_report_dayStringDay of the report of fraudulent2020-03-24 14:22:15 
alerts:reason_code_descriptionstringDescription of reason codeFraudulent Use of Account Number 
metadataObjectThe customer was detected on the merchant end to be the suspicious oneTRUE 
metadata:next_page_iteratorStringUnique hash for receiving new data. If it's null - all data was successfully getting by the merchant7kUDYhPqjhcLDfzo00hfoazbdLexUCadNzFQ3 

Example of a successful response

{
  "alerts": [
    {
      "created_at": "2020-03-24 12:24:37",
      "order_id": "1585052478109",
      "fraud_amount": 5400,
      "fraud_currency": "USD",
      "fraud_amount_usd": 5400,
      "fraud_type": "6",
      "card_scheme": "VISA",
      "fraud_report_date": "2020-03-24 14:22:15",
      "reason_code_description": "Fraudulent Use of Account Number"
    }
  ],
  "metadata": {
    "next_page_iterator": null
  }

The merchant would automatically receive information about the new Fraud Alert on the Callback URL, which was provided with order creation.

Parameters of the callback with fraud alert information

ParameterTypeDescriptionValue sample
order_idStringOrder ID777
fraud_amountIntegerFraud order amount - integer without fractional component (i.e cents). For instance, 1020 means 10 USD and 20 cents.2575
fraud_currencyStringFraud order currency (3 letter code under ISO 4217)USD
fraud_amount_usdIntegerFraud order amount in USD12367
fraud_typeIntegerType of fraud6
card_schemeStringCard SchemeVISA
fraud_report_dayStringDay of the report of the fraud2020-03-24 14:22:15
reason_code_descriptionstringDescription of reason codeFraudulent Use of Account Number

Example of a successful response

{
  "order_id": "1584714374170",
  "fraud_amount": 100,
  "fraud_currency": "USD",
  "fraud_amount_usd": 100,
  "fraud_report_date": "2020-03-20 14:26:15",
  "card_scheme": "VISA",
  "fraud_type": "6",
  "reason_code_description": "Fraudulent Use of Account Number"
}