Integration Guide
Last updated Sept 24th, 2022
Overview
With this guide, you will learn how to integrate DirectPay into your application, and initiate direct transfer payments from your customers. By following this guide you will be able to initiate transfer payments from your customer's bank account seamlessly. To integrate Directpay into your web or mobile app, the following steps need to be taken:
Prerequisites
To integrate DirectPay into your web or mobile app, ensure that you:
- Initiate the payment request
- Await and confirm payment from the customer
- Track or verify payment
Integration Guide
Initiate your payment widget
You need to initiate the payment request via the API or Mono connect widget, which begins the payment process.
One-time Payment
To initiate a one-time payment, an amount, type (i.e., onetime-debit), description, reference, account id (not required), and redirect URL can all be populated on the Initiate endpoint. Once this is provided, a payment link is generated, which your customers can open in their browsers or mobile app in form of a web view.
Redirection URLs
The customer will be redirected to the redirect URL after a successful or failed attempt. The URL includes the reference that was passed when initializing the widget and the status and reason in case of failure.
Success: ${redirect_url}?reference="reference"&status="successful"
Failure: ${redirect_url}?reference="reference"&status="failed"&reason="widget_closed"