Base URL
https://api.business.bumxpress.com
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.
