Skip to main content

How do I check the status of a payment programmatically?

Poll the payment status endpoint or use webhooks to receive real-time status updates.

1. Polling Send GET /v1/payments/{paymentId} to retrieve the current payment object.

💡 Tip: Use exponential back-off when polling: check after 2s, then 4s, then 8s.


​

2. Webhooks (recommended) Register a webhook endpoint to receive payment.completed and payment.failed events automatically.


​

3. The payment object includes: id, status, amount, currency, recipientId, reference, createdAt, updatedAt, and failureReason.


​

Related articles:

Did this answer your question?