> For the complete documentation index, see [llms.txt](https://docs.bellmfb.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bellmfb.com/getting-started.md).

# Getting Started

To begin integrating the Bell BASS API:

1. Obtain your API key from the Bell BASS developer portal.
2. Familiarize yourself with the API endpoints and the required request/response formats.
3. Start by integrating the service most critical to your application, whether it’s bank transfers, virtual accounts, utility bill payments, or webhooks.
4. Implement comprehensive error handling and security measures.

By following this guide, you can seamlessly integrate the Bell BASS API into your application, providing robust and secure financial services to your users.

For more detailed information, please refer to the Bell BASS API Reference Documentation or contact our support team at <support@bellmfb.com>.

```
BASE URL SANDBOX: https://sandbox-baas-api.bellmonie.com
BASE URL PRODUCTION: https://baas-api.bellmonie.com
```

## Generate Token

Use **consumerKey**, **consumerSecret** and **validityTime** at the header to generate a tok

`POST` `/v1/generate-token`

Use **consumerKey**, **consumerSecret** and **validityTime** at the header to generate a token&#x20;

**Headers**

| Name           | Value                | Description               |
| -------------- | -------------------- | ------------------------- |
| Content-Type   | `application/json`   |                           |
| consumerKey    | `{{consumerKey}}`    | obtain from the dashboard |
| consumerSecret | `{{consumerSecret}}` | obtain from the dashboard |
| validityTime   | `{{validityTime}}`   | in minutes Max 48 Hours   |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "success": true,
    "message": "Token generated successfully",
    "token": "eyJhbGciOiJIUz9.eyJidXNpbmVzc0lkIjoyMCwidXNlcklkIjo1NDIsInN0YXR1cyI6ImIsImlhdCI6MTcxNjczNzQ0NX0.Avy8w4f-B3432zBeo9a7HXdI1M4XvARVO_XGo"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "success": false,
    "message": "Failed to generate token",
}
```

{% endtab %}
{% endtabs %}