IdealBoxPay

Payment methods

Take the method your customer already has.

A checkout that only offers cards loses most of a market where cards are the exception. IdealBox takes mobile money, cards and PayPal behind one request — and the list grows without you shipping anything.

Methods live
4
Markets live
4
Settlement currencies
2
Corridors that pay out
4

Catalogue

What we can move.

Each method resolves through one of six flows. Your integration branches on the flow, never on the provider — which is why enabling a new one costs you nothing.

MTN MoMo

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Push to the handset · Redirect and return
Money back
Payout

Orange Money

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Redirect and return
Money back
Refund

Visa · Mastercard

Card

Where
Cameroon
Amount range
300–5,000,000 XAF
Payer does
Redirect and return
Money back
Refund

PayPal

PayPal

Where
Cameroon
Amount range
600–5,000,000 XAF
Payer does
Redirect and return
Money back
Refund
Coming soon

Apple Pay

Apple Pay

Modelled, with no corridor behind it yet.

Coming soon

Google Pay

Google Pay

Modelled, with no corridor behind it yet.

Coming soon

Wave

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Money back
Payout
Coming soon

M-Pesa

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Money back
Payout
Coming soon

Airtel Money

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Money back
Payout
Coming soon

Moov Money

Mobile money

Where
Cameroon, Republic of the Congo, Côte d'Ivoire, Benin
Amount range
100–1,000,000 XAF · XOF
Payer does
Money back
Payout
Coming soon

Bank transfer

Bank account

Modelled, with no corridor behind it yet.

Flows

Six ways a customer completes a payment.

The response to a payment tells you which of these you are in, and what to render. That is the entire client-side contract.

DEVICE_PUSH

Push to the handset

The customer gets a USSD or in-app prompt and enters their PIN. Nothing happens in the browser — most mobile money runs this way.

REDIRECT

Redirect and return

The browser goes to the provider — a 3-D Secure challenge, a Wave page, a PayPal login — and comes back to your return URL.

OTP_CHALLENGE

One-time code

The provider issues a code the customer reads out. You collect it and submit it to confirm the payment.

DIRECT

Nothing more needed

The instrument is already authorised — a tokenised card. It resolves on the first call.

QR_DISPLAY

Show a QR code

Render the code we return and the customer scans it with their wallet app. Useful in person and on desktop.

VOUCHER_INSTRUCTION

Account and reference

Show the customer where to send funds and the reference to quote. We match the inbound transfer and resolve the payment.

Coverage

Every corridor we can settle

Country is data here, not a code change — a market is rows in a capability table, which is why this list grows without an API version.

Amount ranges are in whole francs, widened across every route a method takes. A corridor that cannot pay out can still be collected on.
CountryMethodAmount rangePay out
CameroonXAFMobile money100–1,000,000Yes
Republic of the CongoXAFMobile money100–1,000,000Yes
Côte d'IvoireXOFMobile money100–1,000,000Yes
BeninXOFMobile money100–1,000,000Yes
CameroonXAFCard300–5,000,000Collect only
CameroonXAFPayPal600–5,000,000Collect only

Ask what will work before you render anything

One call returns exactly the methods that can take this amount, in this currency, in this country — including limits and whether refunds are supported. Build your checkout from the response and a newly enabled method shows up without a deploy.

curl "https://secure.idealbox.org/v1/providers?country=CM&currency=XAF&amount=500000" \
  -H "Authorization: Bearer ib_sk_test_4f2a9c1e8b7d6053"

Directions

Money in, money out, money held.

Collections and disbursements are both first-class from day one. Your balance is a liability on our ledger, and you decide when to withdraw it.

Collect

Charge a customer on any supported method. Full and partial refunds where the provider allows them.

Disburse

Send money to a third party — a driver, a seller, a supplier — over mobile money or a bank transfer.

Withdraw

Move your own cleared balance to a bank or mobile money account. Per-wallet withdrawal blocking when you need it.

Payment links

One-time or reusable hosted links, for when you would rather not build a checkout at all.

// Coming with phase 5. The envelope is the same in reverse: an amount in
// minor units, a currency, and a destination the corridor supports.
const payout = await idealbox.disbursements.create({
  amount: '250000',
  currency: 'XOF',
  reference: 'driver-payout-88',
  destination: {
    methodType: 'MOBILE_MONEY',
    country: 'SN',
    phoneNumber: '+221770000000',
  },
});

Start in the test environment. Move money when you are ready.

Create an account, take a test key and run a payment end to end in minutes. Going live is a different key, not a different integration.

No setup fee. No monthly minimum on Start.