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

# Error codes

> Common checkout error codes and failure scenarios.

The checkout API returns error codes when operations fail. The most common codes are listed below.

***

## Error codes

| Code  | Description                       |
| ----- | --------------------------------- |
| `100` | Invalid mobile number             |
| `101` | Invalid amount                    |
| `102` | Invalid transaction ID            |
| `120` | Invalid authentication parameters |

***

## Common failure scenarios

<AccordionGroup>
  <Accordion title="Incorrect reference number or inactive route">
    The reference number does not match any active checkout route pattern. Verify your route pattern in **BPAY → Routes → Checkout** (e.g. `SAMPLE*` matches `SAMPLE-12345`).
  </Accordion>

  <Accordion title="Session expiry">
    Payment sessions expire after **10 minutes**. If the customer does not complete payment within this window, they must restart the checkout flow.
  </Accordion>

  <Accordion title="Payment failure">
    The customer may see a payment failure screen if the mobile money transaction is declined or times out. Your [callback](/guides/payments-checkout/callbacks) will receive `status: "failed"`.
  </Accordion>

  <Accordion title="No payment method configured">
    **HTTP 404** — no payment method has been set for your account or route. Contact Beem support to configure payment methods.
  </Accordion>
</AccordionGroup>