Laos QR Banking - Purchase

General information

To perform a purchase by using Payment Page with the Laos QR Banking payment method:

1. Send a request with all the required parameters and signature to the Monetix URL.
2. Accept the callback with the purchase result from the payment platform.

The following figure shows the complete purchase processing flow in the Laos QR Banking payment method.

Request

The following table lists the parameters that you need to include in the request for purchase through the checkout page with the Laos QR Banking payment method.

Here is an example of the data from a request to open the checkout page by using EPayWidget:

EPayWidget.run(
	{
		project_id: 1234,
		payment_id: 'payment_47',
		customer_id: 'customer_123',
		customer_email: 'johndoe@example.com',
		account_customer_name: 'John Doe',
		payment_currency: 'LAK',
		payment_amount: 10000000,
		force_payment_method: 'banks-laos-qr',
		signature: 'kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=='
	}
)

Displaying bank icons on the checkout page

In the Laos QR Banking payment method, the payments are performed through specific banks. When making a purchase on the checkout page, the customer first chooses a payment method and then selects the bank.

The Laos QR Banking payment method offers several options to display bank icons on the checkout page:

• Choosing the bank in two steps First, the customer chooses Laos QR Banking among other payment methods, and then selects the bank from the list. This is the default behavior.
• Displaying banks alongside other payment methods To display banks as separate buttons on the checkout page alongside the other payment methods, add the payment_methods_options object with the split_banks parameter to the request and set the value of this parameter to true.

  Here is an example of the payment_methods_options object from the link to open the checkout page:

  payment_methods_options={"banks_laos_qr": {"split_banks": true}}
  

• Displaying only banks of the Laos QR Banking payment method For the customer to see only banks available in the Laos QR Banking payment method (without other payment methods), add the force_payment_method parameter to the request and set it to banks-laos-qr.
• Displaying only specific banks To show the customer only specific banks available in the Laos QR Banking payment method, use the force_payment_method parameter with the banks-laos-qr value in the request, add the payment_methods_options object with the split_banks parameter and set this parameter to true. Next, specify the IDs of the banks to display in the banks_id array.

  Here is an example of the payment_methods_options object from the link to open the checkout page:

  payment_methods_options={"banks_laos_qr": {"split_banks": true, "banks_id": [140, 141]}}

  Here is an example of the data from a request with preselected banks to open the checkout page with EPayWidget.

  EPayWidget.run(
      {
          project_id: 1234,
          payment_id: 'payment_47',
          customer_id: 'customer_123',
          customer_first_name: 'John',
          customer_last_name: 'Doe',
          customer_email: 'johndoe@example.com',
          payment_currency: 'LAK',
          payment_amount: 10000000,
          force_payment_method: 'banks-laos-qr',
          payment_methods_options: '{"banks_laos_qr": {"banks_id": [140, 141]}}',
          signature: 'kUi2x9dKHA5VNU0FY...vySO2RLCv1htT4DqtVUkDJrOcZzUCwX6Re1kpZhkIQg=='
      }
  )

• Enforcing only one bank If you want the customer to go directly to their bank service to complete the payment (without choosing a payment method and bank on the checkout page), use the force_payment_method parameter with the banks-laos-qr value in the request, add the payment_methods_options object with the split_banks parameter and set the value of this parameter to true. Next, specify the ID of the required bank in the banks_id array.

  Here is an example of the payment_methods_options object from the link to open the checkout page:

  payment_methods_options={"banks_laos_qr": {"split_banks": true, "banks_id": [140]}}

  Here is an example of the data from a request to open the checkout page with one preselected bank by using EPayWidget.

  EPayWidget.run(
      {
          project_id: 1234,
          payment_id: 'payment_47',
          customer_id: 'customer_123',
          customer_first_name: 'John',
          customer_last_name: 'Doe',
          customer_email: 'johndoe@example.com',
          payment_currency: 'LAK',
          payment_amount: 10000000,
          force_payment_method: 'banks-laos-qr',
          payment_methods_options: '{"banks_laos_qr": {"banks_id": [140]}}',
          signature: 'kUi2x9dKHA5VNU0FY...vySO/RLCv1htT4DqtVUkDJrOcZzUCwX6Rek7pZhkIQg=='
      }
  )

Bank IDs to be passed in the banks_id parameter

Bank IDs that you can pass in the banks_id parameter to display the icons of specific banks on the checkout page are listed in the corresponding section Banks available for purchase.

Callback

In the Laos QR Banking payment method, the payment platform returns the purchase result in a callback. For the information about the callback structure, see Callbacks in Payment Page.

The following is an example of a callback body with information about a successfully completed purchase.

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Laos qr",
        "sum": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "sale",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "sum_converted": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

The following is an example of a callback for a declined purchase.

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Laos qr",
        "sum": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "sale",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "sum_converted": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Related topics

• Integration procedure
• Payment types, operations and payments
• Signature generation and verification
• Operation statuses and response codes

General information

To perform a purchase by using Gate with the Laos QR Banking payment method:

1. Send a request with all the required parameters and signature to the Monetix URL.
2. Show the screen with a payment QR code to the customer.
3. Accept the callback with the purchase result from the payment platform.

The following figure provides the details of the purchase processing flow in the Laos QR Banking payment method.

Request

This section provides the instructions on how to build the request for purchase with the Laos QR Banking payment method.

Here is an example of the data from a request to initiate a purchase with the Laos QR Banking payment method:

{
    "general": {
        "project_id": 1234,
        "payment_id": "payment_47",
        "signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
    },
    "customer": {
        "id": "customer_123",
        "ip_address": "198.51.100.47",
        "email": "johndoe@example.com"
    },
    "account": {
        "bank_id": 60881,
        "customer_name": "John Doe"
    },
    "payment": {
        "currency": "LAK",
        "amount": 10000000
    }
}

Displaying the payment QR code to the customer

After receiving and processing your purchase request, the payment platform sends you the callback with the data for displaying the payment QR code to the customer.

Use the data from the display_data array to display the QR code to the customer.

{
    "type": "qr_url",
    "title": "qr_url",
    "data": "https://example.com/qr.jpg?v=1"
}

The following is the callback fragment containing display_data array.

"display_data": [
    {
        "type": "qr_url",
        "title": "qr_url",
        "data": "https://example.com/qr.jpg?v=1"
    }
]

Callback

In the Laos QR Banking payment method, the payment platform returns the purchase result in a callback. For the information about the callback structure, see Callbacks in Gate.

The following is an example of a callback body with the information about a successfully completed purchase.

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Laos qr",
        "sum": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "sale",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "sum_converted": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

The following is an example of a callback for a declined purchase.

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Laos qr",
        "sum": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "sale",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "sum_converted": {
            "amount": 10000000,
            "currency": "LAK"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Related topics

• Synchronous and asynchronous message processing
• Payment types, operations and payments
• Signature generation and verification
• Operation statuses and response codes

Supported banks

In the Laos QR Banking payment method, payments are performed through the banks the payment method supports. For the purchase to be performed, your request must contain the ID of the customer's bank in the account.bank_id parameter.

The table below lists the banks available for purchase in the Laos QR Banking payment method.

The table with the list of banks is provided for informational purposes only. It may change without notice. To get the current list of banks the Laos QR Banking payment method supports, contact your key account manager at Monetix.