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

Step 1:

config Redirect URL

Login to the portal system (portal.lailaolab.la)
Go to Setings > Callback URL Setting
input domain,Success URL and cancel URL

Step 2:

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

URL :

https://payment-gateway.lailaolab.com/v1/api/link/payment-link (opens in a new tab)

Method :

POST

Authentication :

Basic Auth

Example:

application/json

      {
      "Content-Type": "application/json",
      Authorization:`Basic ${Buffer.from(`${KEY}`).toString("base64")}`
     }

Note: KEY is your secretKey, you can find your keys on the home page of web portal

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)

Example:

application/json

{
  "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

Example:

application/json

{
  "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.

Read More:

Explore the full Payment Link documentation for detailed integration guidelines .

Click here to access:

Payment Link Documentation (PDF)

Registration Generate QR