Build With MyBundlePay

One integration for payments, cards, bills and payouts.

MyBundlePay gives developers a clean payment gateway, virtual account funding, payout rails, card issuing tools, bill payments, webhooks and merchant-ready checkout experiences.

REST APIs JSON based
Webhooks Real time events
Sandbox Test first

API Test Console

Test the current endpoint directly from the documentation. Secret keys stay inside this browser session.

Enter your test key, review the sample body for this page, then send a request.

Authentication

All MyBundlePay API calls must be authenticated with your secret key. Requests without a valid bearer token return 401 Unauthorized.

Your API key determines whether the request runs in test mode or live mode.

API keys

Your secret key can perform actions on your account, so keep it private and use it only from your backend server.

  • Log in to your MyBundlePay dashboard.
  • Open Settings.
  • Select API keys from the API & Webhook section.
  • Copy your test key for development or live key for production.

Authorizing API calls

Pass your secret key as a bearer token in the request header.


Authorization: Bearer {secret_key}
Accept: application/json
Content-Type: application/json
                        

curl "https://mybundlepay.com/ng/api/get-balance" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {secret_key}"
                        

IP whitelisting recommendation

For stronger protection, whitelist the IP addresses your API requests will come from. This helps prevent unauthorized servers from making requests with your keys.

Manage trusted IP addresses in your dashboard API settings.

Key safety

  • Never put secret keys inside mobile apps or browser JavaScript.
  • Never commit keys to Git.
  • Use environment variables on your server.
  • Rotate keys immediately if you suspect exposure.

Common errors

401: Missing, invalid or expired API key.

403: Key is valid but cannot perform the requested action.

429: Too many requests. Apply retry delays and avoid rapid loops.