Payment Link
1. Overview
This is the flow for using Payment Link with customer platform (who connect with Payment Link)

2. Config redirect URL and Webhook
First of all,it required configuring the Success URL , cancel URL,and Webhook in the Lailao Payemnt Portal
config Redirect URL
Login to the portal system (portal.lailaolab.la)
Go to Setings > Callback URL Setting
input domain,Success URL and cancel URL
config Webhook API
Go to Settings > Webhook Setting
Input Endpiont URL and description
3. Get Payemnt Link
To make a payment with Payment Link through the Bank Platform, it is necessary to create a Link for connecting the bank to use the Mobile Banking App to make the connection. Currently, we can connected to 3 banks in laos such as : BCEL, Joint Development Bank (JDB),Indochina Bank (IB). The way to connect to create a QR is as follows
POST
Basic Auth
Example:
{
"Content-Type": "application/json",
Authorization:`Basic ${Buffer.from(`${KEY}`).toString("base64")}`
}
3.1 Request Body
Field | Type | Description |
---|---|---|
amount | Number | Amount to be create for a transaction |
description | String | Payment description (Note: should not include “ ” space) |
tag1 | String | The first custom field of customer system that want to send to Payment Link (option) |
tag2 | String | The second custom field of customer system that want to send to Payment Link (option) |
tag3 | String | The third custom field of customer system that want to send to Payment Link (option) |
{
"amount": 10000,
"description": "buy products",
"tag1": "shopName",
"tag2": "0133045350345435",
"tag3": "myKey",
}
3.2 Response Data
Field | Type | Description |
---|---|---|
message | String | A string indicating the outcome of the API call |
redirectURL | String | Payment link page URL using for th payment process |
{
"message": "SUCCESSFULLY",
"redirectURL":
"https://payment-link.lailaolab.com?amount=1&linkCode=551f8eb7-1976-4
d1c-b7a9-e0438d752e63"
}
3.3 Redirect to payment link
In this step, the user will be redirected to a secure payment link page to select bank and complete the payment process.
Once you receive the redirect link
open it to navigate to the payment page.
Step 1 : Once you receive the redirect link
open it to navigate to the payment page.

Step 2 : When the user selects their bank, they will be automatically redirected to the QR code page for payment in this page user can open Bank app with App Link or Scan QR for payment

Step 3 : After scanning and completing the payment, the system will display a message for (5) seconds. Then, it will automatically redirect the user to their success callback URL

3.4 Webhook Callback Data
When the transaction is complete it will return callback data to the user's webhook This data is sent as part of the HTTPS request (usually a POST) from the service to your designated webhook URL
Response Data
Field | Type | Description |
---|---|---|
message | String | Status message of the transaction response. |
refNo | Number | Reference number for the transaction. |
billNumber | String | Unique identifier for the bill. |
txnDateTime | String (Date) | Datetime of the payment. |
txnAmount | Number | Transaction amount. |
sourceCurrency | String | Currency of the transaction source. |
sourceAccount | String | Account number of the source. |
merchantName | String | Name of the merchant involved in the transaction. |
sourceName | String | Name of the person or entity initiating the transaction. |
description | String | Description or purpose of the transaction. |
exReferenceNo | String | External reference number for the transaction. |
userId | String | Id of user in Phapay system |
transactionId | String | Unique identifier for the transaction. |
status | String | Status of the transaction. |
tag1 | String | Additional tag or note related to the transaction. |
paymentMethod | String | Payment method used (BCEL,JDB,...) |
successURL | String (URL) | Success Callback URL. |
Explore the full Payment Link documentation for detailed integration guidelines .
Click here to access:
Payment Link Documentation (PDF)