Skip to main content

Quick Integration Guide

📡 SDK Integration​

1. Installation and Configuration​

Download the SDK for the relevant platform (Web, iOS, Android, Backend).
Configure it using the API keys provided by the payment aggregator.

2. Integration into the Application​

Use the SDK libraries to display a payment form or handle redirection to a hosted payment page.
Call the SDK APIs to initiate a transaction.

3. Payment Handling and Confirmation​

The SDK communicates with the payment aggregator's servers to validate the transaction.
On success, a callback or webhook is triggered to inform the application that the payment has been confirmed.

4. Security and Compliance​

The SDK includes mechanisms such as data encryption, tokenization, and 3D Secure to ensure transaction security.

🔌 Integration via REST APIs​

A REST API (Representational State Transfer) is an interface that allows applications to communicate with each other over HTTP, following specific architectural principles.

1. API Authentication​

Access to MOALA’s REST APIs is secured using:

API Key: A unique key sent in the header or URL.
API Secret: A second key used to ensure the message has not been altered, typically included in the request header.

2. Making HTTP Requests​

To make HTTP requests, identify the required endpoints and execute them according to the specifications outlined in the documentation.

3. Testing the API Before Integration​

Always test the APIs before integrating them into the production environment to ensure correct use of parameters and proper handling of potential errors during data transmission or response reception.

🔗 Integration via Payment Link​

The integration depends on the payment service provider used.

Here are the general steps:

Some providers allow manual link generation through a dashboard.
This is useful for small businesses or one-time payments.

To automate link creation, you can use a REST API.

E-commerce: Display the link on the order confirmation page.
Billing: Include the link in emails or invoice PDFs.
Customer Service: Send the link via WhatsApp, Messenger, or SMS.

4. Handling Payment Notifications​

Use webhooks to receive real-time payment notifications.