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

# Prerequisites

> Set up your Bpay account, billpay number, and collection product.

Before receiving payments via Bpay Collections, complete account registration and product configuration.

***

## Receiving payments — get started

<Steps>
  <Step title="Register">
    Register on the Beem platform at [login.beem.africa](https://login.beem.africa/#!/register), then verify your email address and phone number to activate your account.
  </Step>

  <Step title="Request a number">
    Navigate to the **BPAY** menu and select **Request a Number**. Fill in your requirements.

    The Beem team will share commercial details and a contract, request KYC documents, and configure a valid billpay number for specific mobile networks.
  </Step>

  <Step title="Configure a collection product">
    1. Log in to [login.beem.africa](https://login.beem.africa/)
    2. Navigate to **BPAY → Products → Collections** and select **Add New**
    3. Configure a product for your collection use case
  </Step>

  <Step title="Set reference patterns">
    Differentiate multiple products using reference number patterns:

    * `BMSMS+*` — matches all reference numbers with the prefix `BMSMS+`
    * `*` — routes all reference numbers to this product
  </Step>

  <Step title="Get API credentials">
    API Key and Secret are available from **BPAY → API Setup**. Authenticate outbound requests using Basic Auth or an access token — see [Authentication](/guides/payments-collection/authentication).

    <Warning>
      Store your API Secret safely — it is only displayed once when generated.
    </Warning>
  </Step>
</Steps>

***

## Requirements

| Item                      | Description                                                            |
| ------------------------- | ---------------------------------------------------------------------- |
| Billpay / merchant number | Provided by Beem after KYC and commercial agreement                    |
| Callback URL              | HTTPS endpoint on your server to receive payment notifications         |
| API Key & Secret          | From BPAY → API Setup — use for Basic Auth or generate an access token |

<Info>
  See [Authentication](/guides/payments-collection/authentication) for request examples.
</Info>