International Payment

Accept international payments in USD with Monnify. Enable customers from over 150 countries to make seamless payments using the same integration flow you already use for local collections.

Feature Activation Required

International Payment is not enabled by default on any account. To request access, navigate to your dashboard, go to Settings > Contract Setup, and toggle on International Payments. The Monnify team will review your request and activate the feature on your account if approved.

How it works

International payments use the same transaction object and integration flow as standard one-time payments. Whether you're integrating via Web SDK, Mobile SDK, or Direct API, simply set the currency to 'USD' instead of the default 'NGN'. All other request parameters and transaction flows remain unchanged.

International USD payments currently support card payments only, and is only available for enabled merchants.

Supported Currencies

Currency	Description
NGN	Nigerian Naira
USD	United States Dollar

Initializing an International Payment

If you are using the Web SDK, simply set the currency parameter to 'USD' when initializing the payment. For Direct API integrations, include 'currencyCode': 'USD' in your transaction request body. The rest of the integration flow remains the same as local payments.

index.html

If using the Direct API :

request.json

Request Parameters

Parameter	Type	Required	Description
amount	Number	Yes	The amount to be paid
customerName	String	No	The name of the customer
customerEmail	String	Yes	The email of the customer
paymentReference	String	Yes	A unique reference for the payment
paymentDescription	String	No	A description for the payment
currencyCode	String	Yes	The currency code (e.g., 'USD')
contractCode	String	Yes	Your Monnify contract code
redirectUrl	String	No	The URL to redirect to after payment completion
paymentMethods	Array of Strings	No	Allowed payment methods (e.g., ['CARD'])

Success Response

response.json

Flow Diagram for Settlement of International Payments

Settlement

Once international payments are enabled on your account, Monnify automatically provisions a USD wallet for your business. This wallet functions similarly to your Naira wallet and serves as the default destination for all USD settlements.

By default, all successful international payment settlements are credited to this USD wallet. However, if preferred, you can configure a domiciliary account as your settlement destination directly from the dashboard under your contract settings.

Rolling Reserve

To help manage the risks associated with international card payments, chargebacks, and disputes, Monnify applies a rolling reserve of 15% on USD settlements.

This means that:

85% of each successful settlement is made available immediately based on your settlement schedule.
The remaining 15% is temporarily withheld for a period of 90 days.

After the 90-day holding period, the withheld reserve is automatically released to your settlement account, provided there are no unresolved disputes or chargebacks associated with the transactions.

Important Notes

USD settlements are processed into your provisioned USD wallet by default.
Merchants may configure a domiciliary account as an alternative settlement destination.
The rolling reserve applies only to international USD transactions.
Reserved funds are automatically released after 90 days if no disputes are recorded.

International payment settlement diagram