Webhooks

Overview

You can create webhooks to set up callbacks and get notified about certain events from Cardaq Gate. Once created, Cardaq Gate will contact your servers whenever a hooked event fires. You do not need to do it for each individual order: setting up a webhook once will fire for all related events.

To receive callbacks as a Partner, you can select the “Partner webhooks” radio button in the “Webhooks type” section. After that, you need to select the connected merchants, for which you want to receive the callbacks, in the “Connected merchants” section. When a callback is received, the body of the callback will contain the merchant ID by which you can identify the particular connected merchant.

Supported Event Types

Event ID Description
order.issued an order has been issued
order.payment_success customer has successfully paid for the order
order.payment_failure an error has occurred during the order payment
order.hold funds for the order have been reserved
order.canceled an order has been cancelled; additionally, if funds were reserved for this order (skip_capture = true), they will be returned
order.in_progress an order has been issued and is being processed
order.invoice_viewed customer has viewed the invoice for this order
order.invoice_refunded merchant has refunded the invoice for this order
order.invoice_reversal merchant has reversed the invoice for this order
order.refund_failure an error occurred during the invoice refund
order.invoice_refund_reversed a refund has been reversed
order.refund_init_failure an error has occurred during the process of initialization of a refund
order.reversal_init_failure an error has occurred during the process of initialization of a reversal
order.reversal_failure an error occurred during the invoice reversal
order.refund_in _progress an invoice refund is being processed
order.reversal_in _progress an invoice reversal in being processed
order.received an order has been received
order.rejected an invoice has been rejected by the customer
order.expired an order has expired
order.chargeback a chargeback has been received
order.representation a representation has been processed
order.retrieval a retrieval request has been received
order.pre-arbitration a pre-arbitration has been received
order.good_faith a good faith has been received
order.fraud_advice a fraud advice has been received
oct.issued an OCT order has been issued
oct.success an OCT transaction has been successfully executed
oct.failure an error has occurred during OCT transaction execution
card.created customer's card data has been saved
card.deleted customer's card data has been deleted
card.updated customer's card data has been updated

You can alternatively set all_events to true to hook all events to the same callback URL in one request.

Jump to
  • Overview
  • Supported Event Types