├── phpunit.xml ├── LICENSE └── ReadMe.md /phpunit.xml: -------------------------------------------------------------------------------- 1 | 2 | 7 | 8 | 9 | ./tests 10 | 11 | 12 | 13 | 14 | ./app 15 | ./src 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Copyright 2023 Blessed Jason Mwanza 2 | 3 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so. 4 | 5 | THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 6 | 7 | End license text. -------------------------------------------------------------------------------- /ReadMe.md: -------------------------------------------------------------------------------- 1 | # MoneyUnify Payments API Library - [Documentation](https://owk7kqf8sn.apidog.io/) 2 | 3 | The [MoneyUnify](https://moneyunify.one) is a developer-friendly API Library plugin to accept payments, instant transfers, split payments, send payouts, and manage your startup business easily. [**MoneyUnify**](https://moneyunify.one) allows you to easily Validate your ideas with confidence and supports mobile money payments for all network operators 🚀 4 | 5 | - [Documentation for all programming languages](https://owk7kqf8sn.apidog.io/) can be accessed [HERE](https://owk7kqf8sn.apidog.io/) 6 | 7 | image 8 | 9 | 10 | --- 11 | 12 | 13 | ## Setup 14 | 15 | - Create an account on [MoneyUnify](https://moneyUnify.one) 16 | - Login and create your startup business from the [businesses section](https://moneyunify.one/businesses). 17 | - Grab your Auth key and follow the documentation to begin collecting repayments using any programming language of your choice. 18 | 19 | - **No** need for bulk **KYC**. 🚫📝 20 | 21 | - Customer support is available via - 📞 [WhatsApp ](https://wa.me/+260971943638) 🤙🏾 22 | 23 | - **install Settlements and withdraws** through the API Dashboard to all mobile networks 🌍 24 | 25 | - Collect Money from All 3 networks; `MTN`, `Airtel`, and `Zamtel` instantly. 🚀 26 | 27 | 28 | 29 | ## 💸 Example: Request a Payment 30 | 31 | ```js 32 | fetch("https://api.moneyunify.one/payments/request", { 33 | method: "POST", 34 | headers: { 35 | "Content-Type": "application/x-www-form-urlencoded", 36 | "Accept": "application/json" 37 | }, 38 | body: new URLSearchParams({ 39 | from_payer: "09xxxxxxxx", 40 | amount: "1", 41 | auth_id: "pub_69b9y3n0h0ydbq" 42 | }) 43 | }) 44 | .then(res => res.json()) 45 | .then(data => console.log(data)) 46 | .catch(err => console.error(err)); 47 | ```` 48 | 49 | ### Example Response 50 | 51 | ```json 52 | { 53 | "message": "Transaction Initiated Successfully", 54 | "data": { 55 | "status": "initiated", 56 | "amount": 1, 57 | "transaction_id": "sPX215101815432505", 58 | "charges": 0.035, 59 | "from_payer": "260971xxxxxxx" 60 | }, 61 | "isError": false 62 | } 63 | ``` 64 | 65 | --- 66 | 67 | ## 🔍 Example: Verify a Payment 68 | 69 | ```js 70 | fetch("https://api.moneyunify.one/payments/verify", { 71 | method: "POST", 72 | headers: { 73 | "Content-Type": "application/x-www-form-urlencoded", 74 | "Accept": "application/json" 75 | }, 76 | body: new URLSearchParams({ 77 | transaction_id: "rp_vd89gdn10d1", 78 | auth_id: "pub_69b9y3n0h0ydbq" 79 | }) 80 | }) 81 | .then(res => res.json()) 82 | .then(data => console.log(data)) 83 | .catch(err => console.error(err)); 84 | ``` 85 | 86 | ### Example Response 87 | 88 | ```json 89 | { 90 | "message": "Transaction processed Successfully", 91 | "data": { 92 | "status": "successful", 93 | "amount": "1.00", 94 | "transaction_id": "LP101815411535505", 95 | "charges": "0.04", 96 | "from_payer": "26097xxxxxxx" 97 | }, 98 | "isError": false 99 | } 100 | ``` 101 | 102 | ### Other examples 103 | Find more examples for different programming languages [here](https://owk7kqf8sn.apidog.io/) 104 | 105 | --- 106 | 107 | **📘 Tip:** 108 | Use your `auth_id` from your [MoneyUnify Businesses Dashboard](https://moneyunify.one/businesses) to authenticate all API calls. 109 | 110 | 111 | --- 112 | 113 | ## Conclusion 114 | 115 | The MoneyUnify library simplifies the process of integrating with the Money Unify API. By following the steps outlined in this documentation, you can easily set up and make payment requests, verify transactions, and settle funds. For further assistance, feel free to reach out or check the official documentation for more advanced features. 116 | 117 | --- 118 | 119 | # >> Built with a lot of ❤ by /> 120 | 121 | 👤 [**Blessed Jason Mwanza**](https://blessedjasonmwanza.github.io) - show support 💖🙌 [Buy him a Coffee](https://www.buymeacoffee.com/mwanzabj) 122 | 123 | - LinkedIn: [Connect with Blessed on LinkedIn](https://www.linkedin.com/in/blessedjasonmwanza) 124 | - Github: [@blessedjasonmwanza](https://github.com/blessedjasonmwanza) 125 | - X (Twitter): [Follow Blessed Jason @mwanzabj](https://x.com/mwanzabj) 126 | - Youtube: [Youtube](https://www.youtube.com/@blessedjasonmwanza) 127 | - Portfolio: [Portfolio](https://blessedjasonmwanza.github.io) 128 | 129 | ## 🤝 Contributing 130 | 131 | Feel free to contribute to this project by submitting a pull request. Your contributions help improve the library and enhance the experience for all users! 132 | 133 | Feature requests are welcome! Check the [issues page](https://github.com/blessedjasonmwanza/MoneyUnify/issues) or request a feature by creating a new issue. 134 | 135 | ## Show your Support 136 | 137 | If you find this library helpful, consider supporting it by sharing it with others or [donating](https://www.buymeacoffee.com/mwanzabj). Your support is greatly appreciated! 138 | --------------------------------------------------------------------------------