Skip to content

Chargeback

Chargeback is a dispute process initiated by a cardholder through the issuing bank to recover funds from a transaction that is believed to be incorrect, unauthorized, or problematic.

When a chargeback occurs, we will notify you asynchronously via notification/callback.

Notification / Callback

Content-Type: application/json
{
    "eventType": "CHARGE_CHARGED_BACK",
    "data":  {
        "chargeDetails": {
            ...  # other fields
            "transferDetails": {
                "card": {
                    ...  # other card fields
                    "chargebackInfo": {
                        "category": "OTHER",
                        "reasonCode": "1999",
                        "reasonMessage": "Not Classified"
                    }
                }
            },
            "transferStatus": "CHARGED_BACK",
            ...  # other fields
        }
    }
}

Object Parameters

Chargeback Info
Parameter Type Description
category String The category of the chargeback.
reasonCode String The code for chargeback reason.
reasonMessage String The explanation for the chargeback reason.
Category
Parameter Description
FRAUD The payment was suspected to be fraudulent.
AUTHORIZATION The payment has an authorization issue.
CUSTOMER_DISPUTE The payment was disputed by the customer.
PROCESSING_ERROR The payment was identified as incorrect during subsequent processing.
OTHER The payment needs to be charged back due to an unclassified reason.

Reason Code

Error code Error message
1001 Fraud - chip liability shift
1002 Fraud - card not present
1003 Fraud - no authorization
1101 No authorization
1201 Credit not processed
1202 Products or services not received
1203 Products or services not as described or defective
1204 Products or services cancelled
1301 Invalid card number
1302 Incorrect amount
1303 Incorrect currency
1304 Duplicate processing
1305 Paid by other means
1399 Processing error
1999 Not classified
Back to top