Use the Pay1st Console to generate the Webhooks and Callbacks for your integrations
Used in Gateway Integration
Overview
Partners will receive webhook notifications when chargeback(dispute) concludes.
Chargeback Configuration
Partners need to configure a webhook URL for receiving chargeback results.
| Name | Type | Description |
|---|---|---|
| Chargeback Webhook URL | String | This is used in order to send chargeback results to the Partner backend server. |
Sample Webhook Payload
{
"chargebackReference": "CB-11111",
"transactionReference": "C-12345-T",
"partnerReference": "PTN_REF_001",
"chargebackAmount": 100.00,
"currencyCode": "ZAR",
"reasonCode": "FRAUDULENT",
"reasonDescription": "Fraudulent transaction",
"status": "LOST",
"responseDeadline": "2026-03-11T12:00:00Z",
"timestamp": "2026-03-10T12:00:00Z"
}Payment Webhook Event List of Fields
The table below lists all the fields available in payment webhook events:
| Name | Type | Description |
|---|---|---|
| chargebackReference | String | A unique identifier that identifies the chargeback transaction |
| transactionReference | String | The original Pay1st transaction reference for the request |
| partnerReference | String | The original reference provided by the partner in the transaction |
| chargebackAmount | Number | The amount of the chargeback |
| currencyCode | String | The currency code used for the chargeback |
| reasonCode | String | Indicates the reason code for the chargeback. Possible values areFRAUDULENT, DUPLICATE, PRODUCT_NOT_RECEIVED, PRODUCT_UNACCEPTABLE, CREDIT_NOT_PROCESSED, SUBSCRIPTION_CANCELLED, AUTHORIZATION_ERROR, GENERAL, OTHER |
| reasonDescription | String | Describes the chargeback in more detail |
| status | String | The status of the chargeback. Valid statuses are WON, LOST, CANCELLED |
| responseDeadline | String | The date that the chargeback needs a response by |
| timestamp | String | The date when the chargeback has been sent |