Legacy webhooks and event types

For the current workflow with webhooks, see theWebhooks topic.

Webhooks allow you to retrieve real-time information about payment and payout events.

When webhooks are set up, Nexio sends a POST request with event information to the specified endpoint.

📘

Note

You may also choose to receive a signature header—allowing you to verify the webhook's authenticity.

Event types

Below are the possible values for webhook event types.

Event Type

Description

Example Webhook Body

ACCOUNT_UPDATER_ACCOUNT_CLOSED

Webhook will be sent when the account associated with the card has been closed

Account closed example

ACCOUNT_UPDATER_CONTACT_CARDHOLDER

Webhook will be sent when the card brand advises you to contact the cardholder

Contact cardholder example

CARD_DATA_UPDATED

Webhook will be sent when card data has been updated

Card updated example

CARD_SAVED

Webhook will be sent when card data has been saved

Card saved example

ECHECK_SAVED

Webhook will be sent when echeck data has been saved

Echeck saved example

PAYOUT

Webhook will be sent when any of the following happens:

  • A payout gets submitted (Note: This means that you will receive multiple webhooks when submitting a batch payout)
  • A payout status changes
  • A transfer status changes

Payout event example

SPENDBACK

Webhook will be sent when any of the following happens:

Spendback event example

SUBSCRIPTION_DETAILS

Webhook will be sent when a subscription has been processed

Subscription example

TRANSACTION_AUTHORIZED

Webhook will be sent when a transaction is authorized

Transaction event example

TRANSACTION_CAPTURED

Webhook will be sent when a transaction is captured

Transaction event example

TRANSACTION_PENDING

Webhook will be sent when a transaction is marked as pending

Transaction event example

TRANSACTION_REFUNDED

Webhook will be sent when a transaction is refunded

Transaction event example

TRANSACTION_SETTLED

Webhook will be sent when a transaction is settled

Transaction event example

TRANSACTION_VOIDED

Webhook will be sent when a transaction is voided

Transaction event example

Next steps