Webhooks help customers receive real-time updates on API activity, including the creation and updates of persons, cards, and transactions.


Leveraging Webhooks

As activities occur within a program, Qolo sends a request containing event information to a hosted endpoint configured in Qolo's system. The client's hosted endpoint must be active in order to process the webhook events sent to it.

Webhooks are useful for:

  • Monitoring transaction patterns
  • Maintaining transaction records, as well as tracking KYB/KYC and card status
  • Staying informed about all program activities


Event types

EventDescription
cardSubscribe to receive updates on all card-related events, including PIN changes, fulfillment, status updates, and replacements.
person.createdSubscribe to receive updates when a person's record is created in the Qolos system.
person.verification.successSubscribe to receive a webhook notification when a person passes KYC validation.
person.updatedSubscribe to receive a webhook notification when changes occur to a person's record.
wallet.createdSubscribe to receive a webhook notification when a wallet is created.
account.createdSubscribe to receive a webhook notification when an account is created.
account.activatedSubscribe to receive a webhook notification when an account is activated.
account.closedSubscribe to receive a webhook notification when an account is closed.
account.statusSubscribe to receive a webhook notification when an account status is updated.
account.instrument.createdSubscribe to receive a webhook notification when an account instrument is created.
outside.instrument.createdSubscribe to receive a webhook notification when an external instrument is created.
outside.instrument.updatedSubscribe to receive a webhook notification when an external instrument is updated
auth.approvedSubscribe to receive a webhook notification when a card transaction is successful.
auth.reversedSubscribe to receive a webhook notification when a card transaction is reversed.
auth.declinedSubscribe to receive a webhook notification when a card transaction is declined.
bankeft.credit.receivedSubscribe to receive a webhook notification when an ACH credit transaction is successfully credited to an account.
bankeft.credit.reversedSubscribe to receive a webhook notification when an ACH credit transaction is reversed.
bankeft.credit.returnedSubscribe to receive a webhook notification when an ACH credit transaction is returned.
bankeft.debit.receivedSubscribe to receive a webhook notification when an ACH debit transaction is successfully processed from an account.
bankeft.debit.reversedSubscribe to receive a webhook notification when an ACH debit transaction is reversed.
bankeft.debit.returnedSubscribe to receive a webhook notification when an ACH debit transaction is returned.
transfer.successSubscribe to receive a webhook notification when an internal transfer is successfully completed.
check.clearedSubscribe to receive a webhook notification when a check is successfully cleared.
payment.successSubscribe to receive a webhook notification when a scheduled payment is successfully processed.
payment.failureSubscribe to receive a webhook notification when a scheduled payment fails to process.
company.createdSubscribe to receive updates when a company record is created in the Qolos system.
company.updatedSubscribe to receive updates when a company record is updated in the Qolos system.