Chargeback Transaction

A chargeback transaction occurs when a customer disputes a charge on their credit card statement and requests a refund from their bank. Fraud detection involves identifying and preventing unauthorized or fraudulent chargeback requests.

Chargeback Transaction

post

/api/v1/fraud-detector/transaction/chargeback

Body

orderIdstringrequired

This is a unique identifier for the transaction associated with the order for which the chargeback is being requested.

Example: ORD_10726

reasonstringrequired

The reason for the chargeback. This explains why the chargeback is being requested, such as due to fraudulent activity, unauthorized transactions, or disputes over the product or service.

Example: Product Not Received

statusstring · enumrequired

This key is used to request the chargeback status for a transaction. The possible values are: 'contested': The chargeback has been contested. 'accepted': The chargeback has been accepted. 'defeated': The chargeback dispute has been defeated. 'refunded': The transaction amount has been refunded. 'prearbitration': The chargeback is in the pre-arbitration phase.

Example: contested

Options: contested, accepted, defeated, refunded, prearbitration

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://secctrl.tutelar.io/api/v1/fraud-detector/transaction/chargeback' \
  --header 'Content-Type: application/json' \
  --data '{
    "orderId": "ORD_10726",
    "reason": "Product Not Received",
    "status": "contested"
  }'

200

422

200

{
  "success": true,
  "message": "Chargeback status updated successfully",
  "data": {
    "orderId": "ORD_10726",
    "requestedDateTime": "2024-04-17T11:54:00.466Z",
    "responseDateTime": "2024-04-17T11:54:00.474Z",
    "processedTime": 8
  }
}

If the chargeback status is updated successfully.