Webhook body examples
Every webhook from the simplified process includes a body with minimal information.
This section contains examples of the content returned in the body of a webhook response.
Transaction events
The webhook body is shaped the same for all transaction events in the simplified webhook workflow.
Each webhook contains the following parameters:
eventType
transactionStatus
- For details about the possible values, see the Transaction status reference tables.processMethod
- For details about the possible values, see the Process method reference table.transactionId
Note
For transactions, the body of the webhook contains only a small subset of the possible parameters for a transaction. To view the values for all the available parameters of the transaction indicated in the webhook, use the
transactionId
value with the View transaction by transaction ID or the View transactions endpoint.
Transaction Event Example Body
{
"eventType": "TRANSACTION",
"transactionStatus": 10,
"processMethod": 10,
"transactionId": 211302211
}
Use the webhook response to determine how to react. For example, the processMethod
shows whether the transaction was card-based, echeck, alternative payment method (APM), or something else. If you wanted to ignore all webhooks related to APMs, you would look for any webhook with a value of 20
and then ignore it.
Payout events
The webhook body is shaped the same for all payout events in the simplified webhook workflow.
Each webhook contains the following parameters:
eventType
payoutStatus
- For details about the possible values, see the Payout status reference table.transferStatus
- For details about the possible values, see the Transfer status reference table.payoutId
payoutRef
After registering the webhook URLs for payouts, a webhook gets sent every time a recipient accepts your payout to them through the Interchecks payout provider. For example, after the recipient accepts the payout, the data.transferStatus
changes to 20
.
For information about payout events with other payout providers, contact Integrations Support.
Note
For payouts, the body of the webhook contains only a small subset of the possible parameters for a payout. To view the values for all the available parameters of the payout indicated in the webhook, use the
payoutId
value with the View a payout endpoint or use thepayoutRef
value with the View payouts endpoint.
Payout Event Example Body
{
"eventType": "PAYOUT",
"payoutStatus": 20,
"transferStatus": 20,
"payoutId": 2437652,
"payoutRef": "dfbb8efc-6e85-4973-8f2e-69baf8624ae6"
}
Spendback events
The webhook body is shaped the same for all spendback events in the simplified webhook workflow.
Each webhook contains the following parameters:
eventType
spendbackStatus
- For details about the possible values, see the Spendback status reference table.spendbackId
spendbackRef
Note
For spendbacks, the body of the webhook contains only a small subset of the possible parameters for a spendback. To view the values for all the available parameters of the spendback indicated in the webhook, use the
spendbackId
value with the View a spendback endpoint or use thespendbackRef
value with the View spendbacks endpoint.
Payout Event Example Body
{
"eventType": "SPENDBACK",
"spendbackStatus": 20,
"spendbackId": 2437652,
"spendbackRef": "dfbb8efc-6e85-4973-8f2e-69baf8624ae6"
}
Updated 6 months ago