Bangkok Bank

Online banking

1. The buyer selects BBL to pay.
2. The buyer inputs the account ID and password to enter the bank page.
3. The buyer confirms the order information and completes the payment.
4. The buyer is redirected to the merchant result page.

Bank transfer

1. The buyer selects BBL to pay.
2. The buyer is directed to the payment code page.
3. The buyer inputs the mobile PIN.
4. The buyer enters the bill payment page.
5. The buyer confirms the payment.
6. The buyer is redirected to the merchant result page.

Online banking

About normalUrl

For WAP and App terminals, normalUrl is returned in the response of the pay (One-time Payments) API. Different terminal types have specific integration features when returning normalUrl:

• WAP: The returned normalUrl  is the browser link. The buyer is redirected to the bank payment page and complete the payment by logging in with the account and password.
• App: The returned normalUrl does not trigger the payment method app. It is recommended to render the bank middle page URL directly within the merchant app and set the merchant result page to the browser link instead of the app's scheme. If you use the external redirection to open the bank middle page URL, set the merchant result page to the merchant app's scheme or redirect the browser link to the scheme or deeplink.
• Web: Not supported on PC.

After payments

This payment method does not support refunds. It is recommended to communicate directly with the buyer offline.

Default timeout

If the buyer does not complete the payment, Antom sends you an asynchronous notification of the payment result at the 14th minute. The timeout period for the merchant to wait for the asynchronous notification or inquire about the result must be greater than 14 minutes.

Bank transfer

About normalUrl

• When accepting payments from BBL, you can choose whether to use normalUrl:

• If choosing not to use normalUrl, you can directly render the codeValue in the API response on the merchant page to display the QR code or payment code, reducing page redirections and improving the payment experience.
• If choosing to use normalUrl, redirect your buyer to the address specified by normalUrl and proceed the payment process as indicated in User experience.

• For WAP and App terminals, normalUrl is returned in the response of the pay (One-time Payments) API. The buyer is redirected to the address specified by normalUrl and uses the payment code displayed on the page to proceed with the payment within the mobile banking app or on the offline ATM device. After the payment is completed, the middle page automatically redirects to the merchant result page.
• Different terminal types have specific integration features when returning normalUrl.

• WAP: The returned normalUrl is the payment code and payment operation display page. The buyer copies the payment code and proceeds to the bank app or the ATM based on the payment operation or the screenshot to complete the payment.
• App: The returned normalUrl does not trigger the payment method app. It is recommended that you render the URL page directly within the merchant app and provide payment operation steps to guide buyers to complete the payment.
• Web: The returned normalUrl is the payment code and payment operation display page. The buyer copies the payment code and proceeds to the bank app or the ATM based on the payment operation or the screenshot to complete the payment.

After payments

• After the buyer completes the payment in the bank app, the banking app will not automatically redirect to the merchant's results page. The buyer needs to manually navigate to the transaction initiation app (the merchant app or browser).
• This payment method does not support refunds. It is recommended to communicate directly with the buyer offline.
• Obtain the payment result from the payment result notification (notifyPayment) or by making inquiries (inquiryPayment). Handle the redirection and display of the payment result page to avoid duplicate payments.

Default timeout

The QR code returned by Antom will not be refreshed automatically. When displaying the QR code, use the expireTime parameter value returned in the pay (One-time Payments) API response to display the timeout information. When displaying the payment code, enable the copy function for the payment code and allow the buyer to conveniently paste the payment code into the payment method app.

Response sample

The following is a code example in the payment response:

{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=Xryjdo2GKK4eetbU8mXRkZ%2FNUzRJ9m77mJ9eyTT9VIg%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "6176225925",
                "displayType": "TEXT"
            },
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252Bpti39M%252FUJ2xuD8vdS0ApwEur8PO87jM03WB9zOqjuudotBC0t%252BIfiXsQ0qVtvS9sluQ%253D%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            },
            {
                "codeValue": "|010555303610000 0000006176225925 0000006176225925 150",
                "displayType": "TEXT"
            }
        ],
        "expireTime": "2024-03-26T19:18:18-07:00"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1711505898000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"6176225925\",\"codeValueType\":\"DIGICODE\",\"displayType\":\"TEXT\"},{\"codeValue\":\"|010555303610000 0000006176225925 0000006176225925 150\",\"codeValueType\":\"QRCODE\",\"displayType\":\"IMAGE\"},{\"codeValue\":\"|010555303610000 0000006176225925 0000006176225925 150\",\"codeValueType\":\"BARCODE\",\"displayType\":\"IMAGE_CONVERT\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "THB",
        "value": "150"
    },
    "paymentCreateTime": "2024-03-24T19:18:18-07:00",
    "paymentId": "20240325194010800100188860213229978",
    "paymentRequestId": "PAY_20240325101817745",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=Xryjdo2GKK4eetbU8mXRkZ%2FNUzRJ9m77mJ9eyTT9VIg%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}