Fraud notification service

Afetr a successful transaction with antifraud (payment status CON, PPC, PPN or EST), the merchant may identify that, in reality, a fraud occurred. In this case, the merchant can call the fraud notification service to warn the risk analysis institution about this occurrence. This will refine the analysis process of said institution, making it more accurate and preventing more frauds in the future.

Currently, this API supports the following antifraud institutions:

  • Konduto
  • Fraud Detect
  • ClearSale REST

Call details#

  • Resource: /v1/transactions/{nit}/fraud
  • HTTP method: POST
  • Request format: JSON
  • Response format: JSON
  • Header parameters:
merchant_idMerchant code on Carat Portal. The production and certification codes will be different.< 15 ANYES
merchant_keyMerchant authentication key on Carat Portal. The production and certification keys will be different.< 80 ANYES
Content-TypeIt must be sent with the value application/json.= 15 ANYES


Below is an example of a fraud notification service call using the cURL tool.


To use this example, don't forget to define the variable {{url}} with the value

--request POST "https://{{url}}/e-sitef/api/v1/transactions/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr/fraud"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"


"code": "0",
"message": "OK. Transaction successful.",
"analysis": {
"code": "0",
"message": "Success"

Request parameters#

Currently, there are no parameters to be sent in the request body.

Response parameters#

If successful, the HTTP response code will be 201. Any other code must be interpreted as an error. The table below describes the response parameters of the fraud notification service:

codeCarat Portal response code. Any code different from 0 means failure. Learn more.< 4 N
messageCarat Portal response message.< 500 AN
codeRisk analysis institution response code.< 4 N
messageRisk analysis institution response message.< 500 AN