> ## 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.

# Introduction

> Accept mobile money payments using Beem's hosted checkout page or embedded iframe.

The **Beem Payments Hub (Bpay) Checkout** service lets you accept payments from mobile subscribers through Beem's hosted payment page or an embedded checkout iframe in your application.

<CardGroup cols={2}>
  <Card title="Redirect method" icon="arrow-up-right-from-square" href="/guides/payments-checkout/redirect-method">
    Send customers to Beem's secured hosted checkout page to complete payment.
  </Card>

  <Card title="Iframe method" icon="window-maximize" href="/guides/payments-checkout/iframe-method">
    Embed a checkout button and iframe so customers stay on your website.
  </Card>
</CardGroup>

***

## Checkout flow

```text theme={null}
Customer proceeds to checkout
        │
        ▼
Your application requests Beem checkout
        │
        ▼
Beem hosted payment page / iframe
        │
        ▼
Customer completes payment
        │
        │ HTTP POST callback
        ▼
Your server receives payment status
```

***

## API reference

| Endpoint                                                                                        | Description                                                  |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [Request checkout page](/api-reference/payments-checkout/request-checkout-page)                 | `GET /checkout` — start a redirect checkout session          |
| [Whitelist website](/api-reference/payments-checkout/whitelist-website-for-checkout)            | `POST /whitelist/add-to-list` — required for iframe checkout |
| [Receive checkout callback](/api-reference/payments-checkout/receive-checkout-payment-callback) | `POST /callback` — webhook your server implements            |

***

## Integration methods

| Method   | Guide                                                        | API                                                                                  |
| -------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| Redirect | [Redirect method](/guides/payments-checkout/redirect-method) | [Request checkout page](/api-reference/payments-checkout/request-checkout-page)      |
| Iframe   | [Iframe method](/guides/payments-checkout/iframe-method)     | [Whitelist website](/api-reference/payments-checkout/whitelist-website-for-checkout) |

Both methods use the same [callback](/guides/payments-checkout/callbacks) format for payment status notifications.

***

## What's in this section

* [Prerequisites](/guides/payments-checkout/prerequisites) — account setup and route configuration
* [Authentication](/guides/payments-checkout/authentication) — Basic Auth or access token
* [Redirect method](/guides/payments-checkout/redirect-method) — hosted checkout page integration
* [Iframe method](/guides/payments-checkout/iframe-method) — embedded checkout library
* [Callbacks](/guides/payments-checkout/callbacks) — receive payment status notifications
* [Error codes](/guides/payments-checkout/error-codes) — common checkout errors
* [Sandbox](/guides/payments-checkout/sandbox) — test your integration