Scribd
Upload
66 views7 pages

Monetbil Payment Widget v2.1 en

Monetbil Widget API v2.1 provides a direct payment link for secure HTTPS payments. It allows users to create an account and payment service, then make POST requests to the API with required parameters like amount, phone number, and service key to generate a payment URL. The response will return a JSON with a success status and payment link if valid. It also lists supported mobile operators and currencies for various countries in Africa.

Uploaded by

Dekass
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
66 views7 pages

Monetbil Payment Widget v2.1 en

Monetbil Widget API v2.1 provides a direct payment link for secure HTTPS payments. It allows users to create an account and payment service, then make POST requests to the API with required parameters like amount, phone number, and service key to generate a payment URL. The response will return a JSON with a success status and payment link if valid. It also lists supported mobile operators and currencies for various countries in Africa.

Uploaded by

Dekass
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 7

Monetbil Widget API v2.

www.monetbil.com
This method provides a direct payment link.

Note: For security reasons, all Monetbil APIs are served via HTTPS only. If you do not yet
have a payment service, you can follow these steps :

• Step 1: Create an account->https://www.monetbil.com/try-monetbil


• Step 2: set up a service->https://www.monetbil.com/services/create

2
Base URL
POST https://api.monetbil.com/widget/{version}/{service_key}

Query format

PARAMETER DESCRIPTION REQUIRED

version v2.1 YES

service_key Unique key generated by Monetbil for each service. YES

BODY

amount Amount you want the consumer to pay. YES

phone User predefined phone number. If present, phone_lock changes to NO


true

phone_lock To prevent the phone number from being changed. NO


Default: false

locale Code of the language to be used. (fr or en) NO

operator Operator code to be preset by default. (see table: NO


Operator list)

country Two-letter country code defined in ISO 3166-1. NO

currency Currency to be used. NO


(see table: List of operators)

item_ref Unique reference of the material in your system. NO

3
payment_ref The only order reference in your system. NO
If the order already exists, the transaction will be interrupted.

user The user who makes the purchase in your system. NO

first_name First name of the user. NO

last_name User's name. NO

email E-mail address of the user. NO

return_url Url of redirection after payment. NO

notify_url Url of notification. Documentation NO


https://www.monetbil.com/docs/monetbil-payment-notification-
en.pdf
logo logo Url of your logo to display on the Widget. NO NO

Response in JSON format:


{
"success": true,
"payment_url":https://api.monetbil.com/pay/v2.1/h6hTYFbcxL5UOrPcDRDkz9Gqb1xPMp
}

Response format
PARAMETER DESCRIPTION

success Response status true or false

payment_url Payment link

4
List of operators

country mobile_operator_name mobile_operator_code Min Max Currency

MTN Cameroon Ltd CM_MTNMOBILEMONEY 1 1 000 000 XAF


CAMEROON Orange Cameroun S.A CM_ORANGEMONEY 1 1 000 000 XAF
EXPRESS UNION FINANCE CM_EUMM 100 500 000 XAF

SENEGAL Orange Senegal SA SN_ORANGEMONEY 1 500 000 XOF

ORANGE MONEY RDC CD_ORANGEMONEY 10 1 000 000 CDF


CONGO-KINSHASA Airtel Congo RDC S.A. CD_AIRTELMONEY 100 1 000 000 CDF
Africell RDC sprl CD_AFRICELL 1 000 1 000 000 CDF

LIBERIA Lonestar Cell MTN LR_MTNMOBILEMONEY 1 170 000 LRD

MTN Congo S.A CG_MTNMOBILEMONEY 1 1 000 000 XAF


CONGO-BRAZZAVILLE
Airtel Congo S.A CG_AIRTELMONEY 1 1 000 000 XAF

Airtel Uganda Ltd UG_AIRTELMONEY 500 2 000 000 UGX


UGANDA
MTN Uganda Ltd UG_MTNMOBILEMONEY 500 2 000 000 UGX

MTN Mobile Money Bénin SA BJ_MTNMOBILEMONEY 1 2 000 000 XOF


BENIN
Moov Money BJ_MOOVMONEY 1 2 000 000 XOF

MTN GUINEA GN_MTNMOBILEMONEY GNF


GUINEA-CONAKRY
ORANGE GUINEA GN_ORANGEMONEY GNF

GABON Moov Africa Gabon GA_MOOVMONEY 150 500 000 XAF


2
INFORMATION
For any information, our Teams remain at the disposal of the Integrators.
[email protected]

You might also like