Inline
With the help of Moolre Payment Link Library, developers can build a simple and secure payment collection process for their web apps.
The integration process are as follows
- Initializing Payment
- Complete Payment
- Verifying Payment
You must initialize the payment from your backend in order to to start processing transactions. This step is crucial as it allows you to maintain complete control over the transaction details. To accomplish this, send a POST request from your backend to the start endpoint.
Parameters | Description | Data Type |
---|---|---|
status | Status of the api request
| int |
code | Unique Identifier for the different possible responses | string |
message | Endpoint response message | string |
data | An object that contains below parameters:
| object |
Use public key for this integration
Please you don't need to use your private key with this implementation. What is required for this implementation is your PUBLIC KEY. And also avoid using the key in your frontend.
The frontend application has to send a request to your backend in order to initialize the transaction and obtain the authorization_url. Once your backend has provided the authorization_url, you can load the URL to initialize the transaction.
To verify payment use either webhook (the URL you provided for the initializing payment) or the transactions status endpoint to get the status of the transaction. For the webhook use status and amount , but with the transaction status use txstatus and amount to check if the items or goods should be delivered to the customer or not.
When using the transactions status endpoint Please this enpoint uses X-Api-Key in the header which is your PRIVATE KEY not your PUBLIC KEY. Also do not make this request in your frontend, make the request on your backend and send the response to your frontend.
Below is a sample response for the webhook
Verify amout
Please always verify the amount when verifying the status of the transaction. Always make sure the amount matches the value of the service being delivered. Never deliver to the customer if the amount doen't match
In our effort to make payments more flexible and faster, Moolre introduces a feature that allows bypassing of OTP authentication on all mobile money before payment on specific wallet accounts.
To have this feature enabled on your wallet, contact the Moolre support team by email on [email protected]