Chargeback Webhook Payloads
This page describes the Chargeback webhook payloads in AndDone.
Chargeback Webhook Events
The Chargeback webhook module includes webhook notifications for the following events:
- Transaction.OnChargeback: This payload notification is sent when a chargeback is processed against a merchant payment transaction. This may occur for reasons including disputes over product quality, unauthorized transactions, or non-compliance with the merchant's terms. The specific reason for the chargeback is indicated in the
ReasonCode,Reason, andReasonDescriptionfields.
Chargeback Webhook Payload Fields
The following table provides a reference to the fields included in Chargeback webhook payloads.
| Field | Data Type | Description | MinLength | MaxLength |
| EventCode | Enumeration | TransactionChargeback | 19 | 19 |
| EventDateTime | string | Date/time when the event occurred. | 19 | 19 |
| EventBody | object | Detailed information related to the transaction. | N/A | N/A |
| - MerchantId | string | Unique identifier of the merchant. | 8 | 8 |
| - MerchantReference | string | Unique transaction reference ID provided by the merchant. | 10 | 40 |
| - TransactionId | string | Transaction identifier. | 36 | 36 |
| - TransactionDate | string | Date and time when the transaction was processed. | 19 | 19 |
| - TimeZone | string | The time zone in which the transaction date was recorded. | 6 | 20 |
| - Amount | float | Transaction amount. | N/A | N/A |
| - PaymentMethod | Enumeration | Type of payment used (e.g., ACH). | 3 | 3 |
| - TransactionStatus | Enumeration | Status of the transaction (e.g., Chargeback). | 10 | 10 |
| - TransactionOrigin | Enumeration | Origin of the transaction (e.g., WEB, CCD, PPD). | 3 | 3 |
| - SettlementDate | string | Date on which the transaction funds were settled, if applicable. | 19 | 19 |
| - MaskAccount | string | A partially masked version of the account number involved in the transaction. | 9 | 17 |
| - RoutingNumber | string | Bank routing number for the payment. | 9 | 9 |
| - ChargebackAmount | float | The amount that was charged back. | N/A | N/A |
| - ChargedbackDate | string | Date on which the chargeback was processed. | 19 | 19 |
| - NOCProcessedDate | string | Date on which a Notification of Change (NOC) related to the transaction was processed, if applicable. | 19 | 19 |
| - CardType | string | Type of card used in the transaction, if applicable. | 3 | 9 |
| - CardNumber | string | A partially masked version of the card number used in the transaction, if applicable. | 16 | 16 |
| - ChannelType | string | The type of channel through which the transaction was conducted. | 3 | 16 |
| - ProcessorAuthCode | string | Authorization code provided by the payment processor for the transaction, if applicable. | 6 | 20 |
| - Defendable | boolean | Indicates whether the transaction is defendable in case of a dispute. | N/A | N/A |
| - DisputeStatus | Enumeration | Current status of any dispute related to the transaction (e.g., Lost, Pending). | 4 | 10 |
| - ReasonCode | string | Code representing the reason for the transaction's return. | 2 | 5 |
| - Reason | string | Code representing the reason for the transaction's return or chargeback. | 1 | 50 |
| - ReasonDescription | string | A detailed explanation of the reason for the transaction's chargeback. | 1 | 100 |
| - Success | boolean | Indicates whether the transaction was successfully processed. | N/A | N/A |
| - ErrorMessage | string | Any error message associated with the transaction, if applicable. | 1 | 100 |
| - CorrectedData | string | Any corrected data related to the transaction in the case of a Notification of Change, if applicable. | 1 | 100 |
| AdditionalFields | string | Additional metadata values related to the webhook, if applicable. | N/A | N/A |
| Signature | string | HMAC value used to validate the integrity of the webhook data. | 44 | 44 |
| Version | integer | Version number of the webhook payload format. | 1 | 1 |