notifyDispute
This API is used by Antom to send the dispute information to the merchant.
Structure
A message consists of a header and body. The following sections are focused on the body structure. For the header structure, see:
Note: Set the data type of each field (except array) as String. This means that you must use double quotation marks (" ") to enclose the field value. Examples:
- If the data type of a field is Integer and its value is 20, set it as "20".
- If the data type of a field is Boolean and its value is
true
, set it as "true".
Request parameters
paymentRequestId String REQUIRED
The unique ID that is assigned by a merchant to identify a payment request.
More information:
- Maximum length: 64 characters
disputeId String REQUIRED
The unique ID that is assigned by Antom to identify a dispute.
More information:
- Maximum length: 64 characters
paymentId String REQUIRED
The unique ID that is assigned by Antom to identify a payment.
More information:
- Maximum length: 64 characters
disputeTime Datetime
The date and time when the dispute is created.
More information:
- The value follows the ISO 8601 standard format. For example, "2019-11-27T12:01:01+08:00".
disputeAmount Amount object
The amount of the transaction which has a dispute.
This parameter is returned when a dispute occurs.
disputeNotificationType String REQUIRED
The type of dispute notification. Valid values are:
DISPUTE_CREATED
: indicates that a dispute occurs.DISPUTE_JUDGED
: indicates that the dispute is judged.DISPUTE_CANCELLED
: indicates that the dispute is cancelled by the user.DEFENSE_SUPPLIED
: indicates that your defense documents for the dispute are submitted.DEFENSE_DUE_ALERT
: a warning sent by Alipay that notifies your defense is to be overdue within 24 hours of defenseDueTime.-
DISPUTE_ACCEPTED
: indicates that a dispute is accepted.
More information:
- Maximum length: 30 characters
disputeReasonMsg String
The dispute reason.
More information:
- Maximum length: 256 characters
disputeJudgedTime Datetime
The date and time when the dispute is judged.
More information:
- The value follows the ISO 8601 standard format. For example, "2019-11-27T12:01:01+08:00".
disputeJudgedAmount Amount object
The deduction amount of the dispute.
This parameter is returned when a dispute is judged.
disputeJudgedResult String
The result of the dispute judgement. Valid values are:
ACCEPT_BY_CUSTOMER
: indicates that the dispute is judged to be the buyer's responsibility. Antom unfreezes the captured funds and you can handle the funds freely.ACCEPT_BY_MERCHANT
: indicates that the dispute is judged to be the merchant's responsibility. Antom unfreezes the captured funds but deduct from your settlement account to refund the buyer.
More information:
- Maximum length: 30 characters
defenseDueTime Datetime
The due time after which you cannot defend the dispute.
This parameter is returned when the value of disputeNotificationType is DISPUTE_CREATED
or DEFENSE_DUE_ALERT
.
disputeReasonCode String
The reason code indicating why a payment is disputed. For details about the reason codes, see Chargeback reason codes.
This parameter is returned when the value of disputeNotificationType is DISPUTE_CREATED
or DISPUTE_JUDGED
.
More information:
- Maximum length: 64 characters
disputeSource String
The card scheme that is responsible for processing the dispute.
This parameter is returned when the value of disputeNotificationType is DISPUTE_CREATED
or DISPUTE_JUDGED
.
More information:
- Maximum length: 64 characters
arn String
Acquirer reference number (ARN) of the dispute.
This parameter is returned when the value of disputeNotificationType is DISPUTE_CREATED
.
More information:
- Maximum length: 64 characters
disputeAcceptReason String
Reasons for accepting disputes. Specify this parameter when the value of disputeNotificationType is DISPUTE_ACCEPTED
. Valid values are:
RAPID_DISPUTE_RESOLUTION
: indicates acceptance of the dispute due to Rapid Dispute Resolution (RDR).MERCHANT_ACCEPTED
: indicates acceptance of the dispute initiated by the merchant.TIMEOUT
: indicates acceptance of the dispute due to a timeout scenario, wherein if the merchant fails to defend the dispute within the designated timeframe, the dispute will be automatically accepted.MANUAL_PROCESSING_ACCEPTED
: indicates acceptance of the dispute due to the manual processing.- accepted after manual processing.
disputeAcceptTime Datetime
The time when the dispute is accepted. Specify this parameter when the value of disputeNotificationType is DISPUTE_ACCEPTED
.
Response parameters
result Result object REQUIRED
A fixed value, which is sent to Antom to acknowledge that the notification is received.
Request
Response
Result/Error codes
Code | Value | Message |
---|---|---|
SUCCESS | S | Success |