Chargeback Webhooks

Astra sends webhooks whenever a Chargeback is created or its status is updated.

📘
Chargeback information is available on the transfer object via the GET Transfer API call.

Chargeback Created

Fired when the Chargeback is created.

Parameter	Data Type	Description
webhook_type	`string`	`chargeback_created`
webhook_id	`string`	The unique ID of the webhook event
user_id	`string`	The unique ID of the User
resource_id	`string`	The unique ID of the Resource (Chargeback ID)
resource_parent_id	`string`	The unique ID of the Resource's parent (Transfer ID)

Example:

{
  "webhook_type": "chargeback_created",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA",
  "resource_id": "C999999V1234567890",
  "resource_parent_id": "0239decedaaa5cefa4d173ee839ca37599165219"
}

Chargeback Updated

Fired when the status of a Chargeback has changed.

Parameter	Data Type	Description
webhook_type	`string`	`chargeback_updated`
webhook_id	`string`	The unique ID of the webhook event
user_id	`string`	The unique ID of the User
resource_id	`string`	The unique ID of the Resource (Chargeback ID)
resource_parent_id	`string`	The unique ID of the Resource's parent (Transfer ID)

Example:

{
  "webhook_type": "chargeback_updated",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA",
  "resource_id": "C999999V1234567890",
  "resource_parent_id": "0239decedaaa5cefa4d173ee839ca37599165219"
}

Chargeback Dispute Statuses

Dispute Status	Description
Not Disputed	The chargeback has not yet been disputed by Astra.
Open	The chargeback is currently being disputed by Astra.
Won	The chargeback dispute has been won by Astra.
Lost	The chargeback dispute has been lost by Astra.

Chargeback Statuses

🚧
Note
The contents of the table below correspond to the action_status from the Transfer response object. The action_status , which describes the status of a chargeback, is a legacy field that we recommend not be used for determining the status of a chargeback.

Chargeback Status	Description
Open - Merchant debited	The customer has filed a chargeback with their financial institution. Merchant has been debited the amount listed in the chargeback.
Adjustment - merchant debited	An adjustment has been made to the chargeback. Additional funds have been debited from the merchant.
Adjustment - merchant paid	An adjustment has been made to the chargeback. Funds have been credited to the merchant.
Documentation received	Merchant has submitted documentation to dispute the chargeback.
Representment - Merchant Paid	The chargeback dispute has been ruled in favor of the merchant by the issuing bank. Funds are represented (paid back) to the merchant.
Closed	The final status for most chargeback cases. At this point the merchant has either been debited or credited the disputed amount.
Closed - 2nd Chargeback - Merchant Debited	A second chargeback has been filed for the same transfer, and the merchant is debited again.