Used in Gateway Integration

Overview

Partners will receive webhooks for any chargebacks as well as webhooks for status updates on chargebacks

Chargeback Configuration

Name	Type	Description
Chargeback webhook URL	String	This is used in order to send payment status updates to the Partner backend server. The payload sent to this URL is called Payment Webhook Events

Sample Webhook Payload

{
  "event": "chargeback.status_update",
  "chargebackReference": "CB-11111",
  "transactionReference": "C-12345-T",
  "chargebackAmount": 100.00,
  "currencyCode": "ZAR",
  "reasonCode": "FRAUDULENT",
  "reasonDescription": "Fraudulent transaction",
  "status": "OPEN",
  "responseDeadline": "2026-03-11T04: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
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 are `FRAUDULENT, 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 `OPEN, UNDER_REVIEW, WON, LOST, CANCELLED`
responseDeadline	String	The date at which to respond for the chargeback
timestamp	String	The date when the chargeback has been sent