Introduction
Welcome to Lailao Payment Gateway! In this section, you can find all the information you need to study and use our service, or Lailao Payments API.
The Lailao Payment Gateway is built to address the challenges faced by startup platforms and various legacy systems. It serves as a bridge, transforming these systems to seamlessly connect with the banking system or wallet systems existing in the Lao PDR.
We, at Lailao Payment Gateway, have developed an intermediary to facilitate and support the connection technology for platform owners who wish to transition into FinTech, enabling them to connect to bank and wallet services easily and quickly.
This guide is intended for developers. If you are not a developer but are interested, you can find an overview of the content of our articles and models provided below.
What is Payment Gateway?
Lailao Payment Gateway is a PCI-certified payment gateway featuring an easy-to-use management dashboard and a straightforward REST API model, preferred by numerous API developers.
We prioritize giving you the flexibility to choose your preferred payment process, ensuring it's secure and direct, whether in the test environment or the production environment.
Start creating a developer user or owner platform account with Lailao Payment Gateway
Start by signing up for a trial account to start your operation before production. In both the test environment and the production environment, there is a dashboard showing transaction information, account settings, and sample code to access our API experiments, such as creating or refunding service charges.
Create an example in connection with the experimental model (Test Environment)
To test any of the sample keys on this site, you should replace the sample key shown ($SECRET_KEY or $PUBLIC_KEY) with your account's unique key available on your dashboard.
How to connect with a commercial bank
This is used exclusively for developers to easily connect to the API of commercial banks. The first step is to send information to request a QR String from the bank. After that, you can connect the Socket to wait for the payment results from the bank.
How to create a QR string with bank
Creating a QR string for payment can be done using the link and method below
curl --location 'https://payment-gateway.lailaolab.com/v1/api/payment/generate-bcel-qr?amount=$AMOUNT&description=$DESCRIPTION' \
--header 'secretKey: $SECRET_KEY' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'amount=$AMOUNT' \
--data-urlencode 'description=$DESCRIPTION'
Parameter | Details |
---|---|
secretKey | The value of the code obtained from the account in the Dashboard of the system |
amount | The amount of money that needs to be created to be used for payment |
description | Payment details Note: It should be in English and there should be no spaces in the text because the banking system may consider it incomplete |
Here is the sample of response from the bank
{
"message": "SUCCESSFULLY",
"transactionId": "7d5d7420-e373-431d-b3c0-728a4f138985",
"code": "00020101021133550004BCEL0106ONEPAY0XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXVTE6002LA625105367d5d7420-e373-431d-b3c0-728a4f1389850807okaybor63043561",
"link": "onepay://qr/00020101021133550004BCEL0106ONEPAY0216mcXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX5303418540115803VTE6002LA625105367d5d7420-e373-431d-b3c0-728a4f1389850807okaybor63043561"
}
Response Parameter | Details |
---|---|
message | A message that shows the status of sending a set of messages in creation QR Code |
transactionId | The ID associated with the payment |
code | Text series of creation QR String |
link | A deeplink that can be used to open the merchant banking app for payment |
How to connect Gateway with Socket
To receive trigger information after the End User makes a payment through the Platform, the customer must have a Socket connection to the Gateway to subscribe and wait to hear the answer from the bank through our Gateway. Connecting to Socket We can connect with the method below
https://payment-gateway.lailaolab.com/
After that, the system must listen to the channel below
private_message:$USER_ID
The request
Response Parameter | Details |
---|---|
USER_ID | User ID that can be obtained from Dashboard |
Payment Method
After the Platform receives the QR string and deeplink from Lailao Payment Gateway, the End User can make the payment through the commercial banking app (BCEL ONE).
Check your payment history
After creating a transaction, you can check the history of the previous transaction as well as check the status of the transaction
curl --location 'https://payment-gateway.lailaolab.com/v1/api/payment?user=$USER_ID'