Payment Webhooks
Click the tabs below to see what webhooks you will receive from Coindirect when a customer completes their payment.
The scenario in this example is the following:
The customer broadcasts their transaction on the Network
Coindirect detects the transaction and sends
"event": "transactionDetected"
webhook to notify the merchantCoindirect then updates the payment status from
PENDING
toPROCESSING
and sends"event": "statusChanged"
The transaction gets a required number of confirmations on the Network
Coindirect sends
"event": "transactionConfirmed"
webhook to notify the merchantCoindirect then updates the payment status from
PROCESSING
toCOMPLETE
and sends"event": "statusChanged"
Once you finalize the payment on your side, please ensure that no more transactions will appear on the customer's balance in case you receive further webhooks with the same payment UUID from us - this is to avoid potential issues with duplicate balance transactions.
No under circumstances should you completely rely only on webhooks when finalizing the payment on your side.
Once a webhook is received, we highly recommend making an additional API call to retrieve the payment details via GET /api/v1/pay/:uuid/summary
(link) to check both the status
and displayCurrency.actual
field values.
Webhook Payload Data
See the Webhooks page to get basic information on webhooks and validation.
Last updated