seanmavley / unifi-voucher-payment-server

Unifi Voucher Payment Server

Unifi Voucher Payment Server

A typical use case of the Mazzuma API in making mobile money payments.

To see this repository in action, visit Enjoy WiFi, Today and follow the "Buy Bundle" link.

This repository is complementary to the @seanmavley/unifi-voucher-payment-frontend repository. They both work in tandem to accept Mobile Money payments from Airtel, Tigo and MTN networks in Ghana, responding with a generated voucher code in the end.

See the @seanmavley/unifi-voucher-payment-frontend for more details of the outworkings of the Frontend.

Credits

• Mazzuma's Mobile Money Payments API (HTTP) is in use for the mobile payments.
• Node-UnifiAPI ( @delian/node-unifiapi ) handles the generation of voucher codes, in connection with our self-managed Unifi Controller for AlwaysOn WiFi.
• And many other packages

How it works

• API forwards a request to Mazzuma's API after verifying details from frontend
• API then forwards the response, either success or failed to frontend for processing
• If need be, Frontend polls a callback endpoint for updates. If found, proceeds to generate voucher and sends to frontend.

Run Locally

• Git clone this repository
• Run npm install in project root
• gulp start to view application to kickstart API server.
• At this point, you see errors, therefore, create a .config.js file following what's shown in the .config_sample.js
• Gulp should restart server after changes. If not, you know what to do.

Contributing

PR and Issues are welcome to open. Will appreciate any hints on how to improve the implementation.

Tests

Not yet.

License

See LICENSE

unifi-voucher-payment-server's Issues

Feedback

I watched your video and it watch very helpful. The info you provided has been valuable as the docs on hubtel was a bit confusing (on the transaction flow) at first. After reading more on the Vodafone cash integration, I noticed using it is not much of a problem (I just need an extract text input for transaction code generated for payment).

The UX for the delay in response is my current challenge. I'm thinking through.

I'm working on a nodejs API and I'm trying to their other services for my projects and as open source. Will get back to you. Thanks.