Look up the status of an intent action

GET

/intent-action-status-lookups

Retrieves the current status of a payment intent action along with the status of its parent payment intent. You must supply either intent_action_id or client_reference (or both). This is useful for polling the outcome of an action without storing the internal identifier — pass the client_reference you supplied at action creation time and get the full status picture back.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

The intent action and its parent payment intent were found. Returns current status details for both.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/intent-action-status-lookups?intent_action_id=01HXYZ1234567890ABCDEFGHIJ&client_reference=order_ref_7842a' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Intent action status retrieved successfully",
    "status": "success",
    "data": {
        "id": "01HXYZ1234567890ABCDEFGHIJ",
        "client_reference": "order_ref_7842a",
        "amount": 50000,
        "currency": "NGN",
        "status": "pending",
        "created": "2025-08-05T14:32:00Z",
        "intent": {
            "id": "01HXYZ9876543210ZYXWVUTSRQ",
            "status": "requires_action",
            "client_reference": "cart_session_abc123",
            "amount": 50000,
            "total_paid": 0
        }
    }
}

Modified at 2026-08-05 23:47:00

Compute fees for a transaction

Create a payment intent