🎉 Lailaolab Payment Support is service now. Get Start

v1
Overview

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.

processing

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'
ParameterDetails
secretKeyThe value of the code obtained from the account in the Dashboard of the system
amountThe amount of money that needs to be created to be used for payment
descriptionPayment 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 ParameterDetails
messageA message that shows the status of sending a set of messages in creation QR Code
transactionIdThe ID associated with the payment
codeText series of creation QR String
linkA 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 ParameterDetails
USER_IDUser 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'