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 the payoutRef 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 the spendbackRef 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