Skip to main content

Invoice Webhooks

All invoice webhooks share the following payload structure.

Status Values

The status field can be one of:

StatusTriggered whenExample message
createdInvoice has been created"Invoice created"
pendingClient opened invoice, filled email and selected payment currency. Payment address provided, no deposits yet"User started payment process, but hasn't paid yet"
processingPayment initiation info from blockchain received; waiting for transaction to complete"The client has made a payment, transaction confirmation is pending"
donePayment received successfully. Amount equal to or greater than expected"Invoice paid"
wrongTransaction received, but amount lower than expected"The payment amount is lower than the amount stated on the invoice"
refundedA previously "Wrong"-status invoice declined by the merchant. Funds returned to client"Invoice refunded"
closedInvoice expired. Either "Pending" invoice wasn't paid in time, or "Processing" invoice didn't receive payment within the required time"Invoice closed"