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

# Sandbox

> Test your checkout integration using the Beem dashboard simulator.

Beem provides a checkout simulator on the dashboard to simplify integration and testing without processing live payments.

***

## Access the sandbox

1. Log in to [engage.beem.africa](https://engage.beem.africa)
2. Navigate to the checkout simulator in the Bpay dashboard

The simulator lets you test both the redirect and iframe checkout flows end-to-end, including callback delivery to your configured URL.

***

## What to test

* Redirect checkout flow with valid reference numbers and amounts
* Iframe checkout button and embedded payment page
* Callback receipt and response format
* Session expiry behaviour (10-minute timeout)
* Error handling for invalid reference numbers

<Tip>
  Configure a sandbox callback URL pointing to a test server (e.g. [webhook.site](https://webhook.site) or a local tunnel) before running simulator tests.
</Tip>

***

## Before going live

* Whitelist your production domain (iframe method)
* Configure production callback and redirect URLs on your checkout route
* Verify reference number patterns match your product prefixes
* Store API Key, Secret, and access tokens securely — never expose them in client-side code