Sign in

v1

latestOpenAPI 3.1.02026-07-2656258207.2 KB
Chargebacks

Update a chargeback

Update a chargeback

put/chargebacks/{id}

Path parameters

idstring required

ID of the chargeback

Headers

X-Trace-Idstring

A unique identifier to track this operation. It must be between 12 and 255 characters in length.

Request body

status'accepted' | 'declined'

The status indicates the final resolution of a dispute or request, showing whether it has been accepted or declined.

uploaded_proofstring

Link to proof against chargeback

commentstring

Additional comments for the chargeback

providerstring

Provider for the chargeback

arnstring

Acquirer reference number for transaction

due_datetimestring date-time

The due_datetime specifies the exact date and time by which an action or response is required. This is typically used to set deadlines for submitting documentation or responding to a chargeback.

proof_datastring

Base64 encoded string of proof against chargeback

Example request

{
  "status": "accepted",
  "uploaded_proof": "https://example.com/proofs/proof_123.pdf",
  "provider": "Visa",
  "arn": "1243453453434234534443423",
  "due_datetime": "2025-05-30T23:59:59Z",
  "proof_data": "JVBERi0xLjIgCjkgMAojX"
}

Response

OK

status'success' | 'failed'
messagestring

Example response

{
  "data": {
    "charge_id": "chg_eahdhfThdHsgaSra",
    "amount": 12.34,
    "stage": "new",
    "status": "new",
    "type": "local",
    "due_datetime": "2025-05-30T23:59:59Z",
    "created_datetime": "2025-06-01T23:59:59Z",
    "updated_datetime": "2025-06-01T23:59:59Z",
    "settlement_id": "SETTLEMENT-XYZ-12345",
    "uploaded_proof": "https://example.com/proofs/chargeback-ABC-67890.pdf",
    "comment": "Customer claims service not rendered. Attached signed delivery confirmation.",
    "provider": "Visa",
    "arn": "70010000000000000000001",
    "initiator": "Cardholder"
  }
}