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

POSThttps://secctrl.tutelar.io/api/v1/fraud-detector/transaction/chargeback

Body

application/json

status*enum

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"

contestedaccepteddefeatedrefundedprearbitration

orderId*string

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

Example: "ORD_10726"

reason*string

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"

Response

200422

If the chargeback status is updated successfully.

Body

application/json

successboolean

Example: true

messagestring

Example: "Chargeback status updated successfully"

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://secctrl.tutelar.io/api/v1/fraud-detector/transaction/chargeback', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status": "contested",
      "orderId": "ORD_10726",
      "reason": "Product Not Received"
    }),
});
const data = await response.json();

Response

200422

{
  "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
  }
}