Skip to main content
PATCH
Check Payment Status
Use this endpoint to poll the current status of a PaymentIntent. It is optimized for high-frequency polling from frontends or mobile apps while a customer is completing a payment.

Path Parameters

reference
string
required
The payment_ref or the merchant_reference of the PaymentIntent to check.

Response

Returns the current status and basic transaction info.
status
string
The current status: requires_action, processing, succeeded, failed, canceled.
amount
string
The transaction amount.
currency
string
The currency code.
id
string
The unique transaction ID.