> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pavewaygroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Payment Status

> Lightweight endpoint for polling 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

<ParamField path="reference" type="string" required>
  The payment\_ref or the merchant\_reference of the PaymentIntent to check.
</ParamField>

### Response

Returns the current status and basic transaction info.

<ResponseField name="status" type="string">
  The current status: `requires_action`, `processing`, `succeeded`, `failed`, `canceled`.
</ResponseField>

<ResponseField name="amount" type="string">
  The transaction amount.
</ResponseField>

<ResponseField name="currency" type="string">
  The currency code.
</ResponseField>

<ResponseField name="id" type="string">
  The unique transaction ID.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "data": {
      "id": "658dc...",
      "status": "succeeded",
      "amount": "10000",
      "currency": "XAF",
      "created_at": "2024-01-01T12:00:00Z"
    }
  }
  ```
</ResponseExample>