Skip to main content
POST
Chargeback update

Body

application/json

Chargeback evidence submission request. This API serves two scenarios depending on the chargeback's lifeCycle: FIRST_CYCLE (status ACTION_REQUIRED): submit defense evidence. At least one evidence file is required — supply it through message.documents or evidence.othersFile. SECOND_CYCLE (status SECOND_CYCLE_RESPONSE_REQUIRED, Pre-Arbitration): calling this API — even with message and evidence omitted — defends the case. Evidence submission is not supported in Second Cycle, so message and evidence are ignored. On success the chargeback status becomes UNDER_REVIEW. A successful response means the evidence has passed basic validation and has been accepted by Waffo; Waffo then forwards it to the payment channel for review according to the channel's rules. Calls after expiryDateTime are rejected.

merchantId
string
default:1000000201
required

Merchant Id assigned by Waffo

Maximum string length: 64
Example:

1000000201

chargebackId
string
required

Waffo chargeback order Id

Maximum string length: 32
message
object

Message submitted together with the evidence. message.documents carries the evidence attachments; in FIRST_CYCLE it satisfies the at-least-one-evidence-file requirement, as does evidence.othersFile. Ignored in SECOND_CYCLE.

evidence
object

Additional free-form evidence. Fields are merged per field: a field with a non-blank value overwrites the previously submitted value, and a field that is omitted or blank leaves the previously submitted value unchanged. Repeated calls therefore replace a field's content rather than appending to it. Ignored in SECOND_CYCLE.

Response

200 - */*

OK

response data

code
string
Example:

0

msg
string
Example:

"success"

data
object

Chargeback detail response. Returned by the chargeback inquiry / update / accept APIs, and used as the result object of the CHARGEBACK_NOTIFICATION webhook. It extends the chargeback list item with the message and evidence objects, which the list API does not return.