Quickstart

Base URL

https://api.business.bumxpress.com

All merchant API requests and responses use JSON.

Prerequisites

A Bumxpress Business merchant account
A merchant API key and secret from the dashboard
A unique Idempotency-Key for each create request

Copy your API secret when it is created. The dashboard shows it once and cannot display it again later.

Make a request

Create API credentials

Open the merchant dashboard and create an API key.You will use the public key as X-Api-Key and the secret as X-Api-Secret.

Create a customer

curl -X POST "https://api.business.bumxpress.com/customers" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: bmx_pk_xxx" \
  -H "X-Api-Secret: bmx_sk_xxx" \
  -H "Idempotency-Key: customer_001" \
  -d '{
    "first_name": "Amina",
    "last_name": "Ndongo",
    "phone": "+237670000000",
    "country_code": "CM"
  }'

Create a quote

Generate a payin, payout, or transfer quote before initiating money movement.

curl -X POST "https://api.business.bumxpress.com/quotes/payin" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: bmx_pk_xxx" \
  -H "X-Api-Secret: bmx_sk_xxx" \
  -H "Idempotency-Key: quote_payin_001" \
  -d '{
    "country_code": "CM",
    "operator_code": "CM_MTN_MOMO",
    "rail_type": "mobile_money",
    "send_amount": "10000",
    "send_currency": "XAF"
  }'

Create the payment

Use the quote ID from the quote response when creating a payin, payout, or transfer.

Next steps

Authentication

Send the required merchant API headers.

Mobile money payin

Walk through a complete mobile money collection.

Last modified on July 8, 2026

Getting started

Core concepts

Practical flows

Supporting documentation

Operate

Base URL

Prerequisites

Make a request

Next steps

Authentication

Mobile money payin

​Base URL

​Prerequisites

​Make a request

​Next steps

Authentication

Mobile money payin

Base URL

Prerequisites

Make a request

Next steps