Payment QR Sandbox
1. Introduction
The Payment QR Sandbox is a testing environment that allows developers to simulate QR code-based payment transactions without processing real money. This sandbox provides a complete payment flow simulation including QR code generation, payment processing, and real-time status updates.
1.1 What is the Payment QR Sandbox?
The Payment QR Sandbox is PhaJay’s service that provides for developers connect for testing environment that without processing real money and allowing platform to
Generate QR Codes: create payment QR codes for different banking providers (BCEL,JDB,LDB and IB)
Test Payment Flow: Simulate the complete payment process from QR generation to payment completion
Receive instant notifications: when payments are processed
Real-time Updates: Receive instant notifications when payments are processed as the same with using real money and bank app
Safe Testing Environment: Test your integration without real financial transactions
This makes the sandbox ideal for building and testing payment solutions with confidence before going live
1.2 Registration
To begin using the Payment QR Sandbox, follow these steps
2. Follow registration documentation:
Detailed steps are available at: https://payment-doc.lailaolab.com/v1/registration (opens in a new tab) Upon successful registration, you will receive a public key that enables secure access to the Payment QR Sandbox AP
2. Connect PhaJay Payment QR Sandbox
To begin using the Payment QR Sandbox, follow the steps below to generate test QR codes for various banking providers. This process simulates real QR payment flows without processing actual transactions
2.1 Generate QR Code
You can generate test QR codes for the following supported banks via their respective sandbox endpoints:
- BANQUE POUR LE COMMERCE EXTÉRIEUR LAO PUBLIC (BCEL)
https://payment-gateway.lailaolab.com/v1/api/test/payment/generate-bcel-qr- Joint Development Bank (JDB)
https://payment-gateway.lailaolab.com/v1/api/test/payment/generate-jdb-qr- Lao Development Bank (LDB)
https://payment-gateway.lailaolab.com/v1/api/test/payment/generate-ldb-qr- Indochina Bank (IB)
https://payment-gateway.lailaolab.com/v1/api/test/payment/generate-ib-qr- How to Generate a QR Code
URL : https://payment-gateway.lailaolab.com/v1/api/test/payment/generate-bcel-qr (opens in a new tab)
Method : POST
HEADER : secretKey: <PLATFORM_PUBLIC_KEY>
2.1.1 Request Body
| Field | Type | Description |
|---|---|---|
| amount | Number | The amount of transaction |
| description | String | A description of the transaction or purpose |
| tag1 | string | The first custom field of platform (option) |
| tag2 | string | The second custom field of platform (option) |
| tag3 | string | The third custom field of platform (option) |
{
"amount": 10000,
"description":"ORDER-CHECKOUT",
"tag1": "AppZap Shop",
"tag2": "666bbb461732a2e46233fdf9",
"tag3": "ORDER-0001",
}2.1.2 Response Data
| Field | Type | Description |
|---|---|---|
| message | String | A string indicating the outcome of the API call |
| transactionId | String | A string containing the QR code data |
| qrCode | String | Unique ID for the transaction. |
| link | String | A deep link that can be used to initiate the payment process in a mobile application |
{
"message": "SUCCESS",
"qrCode": "00020101021233500002040104BCEL0216mch6542c0373ede303126XKJCTS4AYPQ5303418540115802LA6003VTE624005126XKJCTS4AYPQ0820paymentfordevversion6304BEEC",
"transactionId": "6XKJCTS4AYPQ",
"link": "phapay://qr/ib/00020101021233500002040104BCEL0216mch6542c0373ede303126XKJCTS4AYPQ5303418540115802LA6003VTE624005126XKJCTS4AYPQ0820paymentfordevversion6304BEEC"
}