In this tutorial, I will teach you how to implement the moncashify sdk to accept payments from your customers in Haiti using the Moncash API. This tutorial can be used in any python project.
This package is compatible with python 2 or 3, so you don't really need to worry about which version you are using. In my case, I am using Python 3.7.
pip install moncashify
Once you have installed it, you can open your project to start using the sdk.
I have a customer who bought in my store, a shoe that costs 1500 HTG. This shoe has a unique ID in my database which is SH023. The goal is to charge the customer, 1,500 HTG from his Moncash account.
To configure your Moncash dashboard, you must have an account. Click on this link to create your own account. Once in the dashboard, go to the General info section to add your business info
After saving all of your business information, you will need a
client_id and a
client_secret. To have these credentials, Go to General info again, and *click View next to the business account you have just created. All the credentials you need, will be below in a section called REST API.
Client Id: f443363451e40d926edd8ff3eb59ca7 Client Secret: fqCEN-jbcK9K_iterjkkjgdUusd1i64cfFg4-LOnqPeS6PO6tDP2KmXwsYjBAt6C
Note that your
client_secret will not be the same as mine. The
client_secret should not be shared with anyone, this is the secret key to keep private. Make sure you have these credentials somewhere, as you will need them.
To start the process, just import the awesome package built for you.
If you previously had the moncashify installed in your project, make sure you install the version 0.3.0 with
pip install moncashify==0.3.0.
Note that I will use the name
client_id = "f443363451e40d926edd8ff3eb59ca7" secret_key = "fqCEN-jbcK9K_iterjkkjgdUusd1i64cfFg4-LOnqPeS6PO6tDP2KmXwsYjBAt6C"
This is information that I have in my database.
order_id = 'SH023' amount = 1500 # HTG
order_id is up to you, and it must be unique, representing your order.
To initialize the connection to the API, do this:
moncash = moncashify.API(client_id, secret_key, True)
The first two arguments are the MonCash credentials, and the third one is for debugging, when I set it to
True, it means I am testing the gateway..
When you are in development, MonCash will not charge you for the transaction if you use some Test Numbers. Note that the credentials will be different when you go live, and different URL will be used to make the payment.
No worries, moncashify handles everything for you, you just need to have the credentials, set
True for development, and to
False when your project goes live.
moncash is the instance to use to make the payment.
payment = moncash.payment(order_id, amount) print(payment) # Payment object - Order ID: SH023, Amount: 1500
And there you are, you've made your first payment. Use the
redirect_url attribute of the instance, to get the redirect URL that the client will use to pay.
url = payment.redirect_url print(url) # https://sandbox.moncashbutton.digicelgroup.com/Moncash-middleware/Payment/Redirect?token=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ1NzgiLCJyZWYiOiJTSDAyMyIsImNydCI6MTU5MTgwNTA0MzQ2NCwiZXh0IjoxNTkxODA1NjQzNDY0LCJhcGkiOnRydWV9.t82yPlU7lk8qEDbVIu_py1dNW89LXsjwkxzcOUm7hvHFbaat3qauiPt30_dBEjhnGt_G-7YuwwdlKhhmWMRFh6HbaRWrDtHwsWripq2If27AOlFsa5TOY8AygEIu79u-QzvOv2u_7rR6VNAejhflPMc5UuK4NJuzcsFR4Z5vy0hI_ZSCrSlz1clZMEqtUtfzshQT4tIQWIG8Vco2DTNMZ9lQmyFqQ2BkXIp19WTS61ot0BAdDxatE7ApF8L4o3KA76wMizIOdNyGA6XH4xMqa6VCU-JoQcH2K56BOUFU9oNLBQwAjh46e5AWy2TCsIE52pYsg4pnFq5HFiIalUGdww
This URL is valid for only 5 minutes, this is the URL that your customer will use to pay you. Actually, the API sends more information, and to get all of it, just call
Open a browser, visit the link and fill out the form with your test account. If you don't have a test number yet, go to the MonCash dashboard and click Add Test Account to create it. By filling this form, you are acting as a customer.
With this test number, you can proceed to the payment test by visiting the link in
redirect_url in your browser. Once you're done with everything, the MonCash API will redirect you to the link provided in Alert Url when you were filling the business form in General Info
You can also get the transaction details with the
transaction = moncash.transaction_details(order_id=order_id) # or transaction = moncash.transaction_details_by_order_id(order_id)
I built this SDK to help you as a pythonist benefiting from the MonCash API. I hope this tutorial will help you implement the SDK very well. If you want to know more about all the features, go to the official documentation.
If you want to contribute to this project, visit the Github.