🎉 Lailaolab Payment Support is service now. Get Start

v1
Connect to Payment Link

Payment Link

1. Overview

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

Overvew image

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

    webhook image
  • input domain,Success URL and cancel URL

    webhook-url image
Step 2:

config Webhook API

  • Go to Settings > Webhook Setting

  • Input Endpiont URL and description

    webhook-url image

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

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

FieldTypeDescription
amountNumberAmount to be create for a transaction
descriptionStringPayment description (Note: should not include “ ” space)
tag1StringThe first custom field of customer system that want to send to Payment Link (option)
tag2StringThe second custom field of customer system that want to send to Payment Link (option)
tag3StringThe 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

FieldTypeDescription
messageStringA string indicating the outcome of the API call
redirectURLStringPayment 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.

payment-link

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

payment-link-qr

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

payment-link-qr-success

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

FieldTypeDescription
messageStringStatus message of the transaction response.
refNoNumberReference number for the transaction.
billNumberStringUnique identifier for the bill.
txnDateTimeString (Date)Datetime of the payment.
txnAmountNumberTransaction amount.
sourceCurrencyStringCurrency of the transaction source.
sourceAccountStringAccount number of the source.
merchantNameStringName of the merchant involved in the transaction.
sourceNameStringName of the person or entity initiating the transaction.
descriptionStringDescription or purpose of the transaction.
exReferenceNoStringExternal reference number for the transaction.
userIdStringId of user in Phapay system
transactionIdStringUnique identifier for the transaction.
statusStringStatus of the transaction.
tag1StringAdditional tag or note related to the transaction.
paymentMethodStringPayment method used (BCEL,JDB,...)
successURLString (URL)Success Callback URL.
Read More:

Explore the full Payment Link documentation for detailed integration guidelines .

Click here to access:

Payment Link Documentation (PDF)