Siam Commercial Bank
For One-time Payments
For Tokenized Payment
Founded in 1907 by the Royal Charter of Thailand, Siam Commercial Bank (SCB) is the first bank in Thailand. SCB is the world's leading universal banking group. SCB has the highest market capitalization in Thailand, which is the bank with the most branches and ATMs.
SCB has more than 15 million Thai users. Currently, the bank supports two different ways to pay: online banking and bank transfer via offline ATMs.
Properties
The properties of the SCB payment method are shown in the following table based on different payment types:
User experience
Note: The following payment flows on different terminals are reference only, and represent this payment method's flow on different terminal types. For supported merchants' terminal types, consult Antom Technical Support.
The following graphics show the user experience for the App terminal in different scenarios.
Online banking
Bank transfer
- The buyer selects SCB to pay.
- The buyer is redirected to the bank page and enters the PIN.
- The buyer confirms the order information.
- The buyer is redirected to the merchant result page.
- The buyer selects SCB to pay.
- The buyer confirms the transaction information in the bank page.
- The buyer is redirected back to the merchant result page.
Supported online payment integrations
Antom offers a range of integration options tailored to each payment method. Each payment method may support different online payment integration options, allowing for flexibility based on your business requirements. The table below provides detailed information about the specific integrations available for each payment method:
Integration considerations
The following section outlines integration considerations for various payment types, detailing customized integration solutions and payment method features.
Online banking
Bank transfer
About normalUrl
- For Web terminal, normalUrl is returned in the response of the pay (One-time Payments) API. The buyer is redirected to the address specified by normalUrl and enters the bank payment page to complete the payment by scanning the QR code with the SCB app.
- For WAP and App terminals, normalUrl is returned in the response of the pay (One-time Payments) API. The buyer is redirected to the payment information page, open the SCB app and input the PIN to complete the payment. After the payment is completed, the buyer is redirected back to the browser page first and then back to the merchant result page.
- The URL returned by the App is the bank middle page, which supports the buyer to launch the bank app for payment. It is recommended to render the bank middle page URL within the merchant app and be compatible with the abilities of applinkUrl and schemeUrl in WebView. Set the merchant result page to the browser link instead of the app's scheme.
After payments
- After completing the bank app payment, redirect the buyer first to the browser page and then back to the merchant result page specified in the paymentRedirectUrl parameter.
- When the buyer selects the online banking method for payment, the bank charges the buyer a handling fee for each transaction. Regarding the specific amount of the handling fee, consult the bank for detailed information.
- 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.
About normalUrl
- When accepting payments from KTB, 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, only normalUrl is returned. After the page redirects, a browser link is opened to display the payment code. The buyer copies the payment code and follows the steps to transfer and pay via the mobile banking app or offline ATM device. After completing the transfer on the phone, the page will automatically redirect to the merchant results 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. Buyers need to manually navigate to the transaction initiation app (the merchant app or browser).
- This payment method does not support refunds. It is recommended that you 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=4HIDfStAMG1yCZHsP6XM0ml9aSsEwkMet7ZAKzCjP3s%3D&clientId=5Y607N2YJU8006726",
"orderCodeForm": {
"codeDetails": [
{
"codeValue": "9329267687",
"displayType": "TEXT"
},
{
"codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252Bptg3%252BhnUtL2QlpjFfdDkjA1p9YgInien3qVAyNCp7uiDXo4RM3fobSrB3OIBqE%252BIFTQ%253D%253D&size=M&sid=188",
"displayType": "MIDDLEIMAGE"
},
{
"codeValue": "|010555303610000 0000009329267687 0000009329267687 230",
"displayType": "TEXT"
}
],
"expireTime": "2024-03-24T00:39:57-07:00"
},
"paymentActionForm": "{"paymentActionFormType":"PaymentCodeForm","paymentCodeExpireTime":1711265997000,"paymentCodeInfos":[{"paymentCodeDetails":[{"codeValue":"9329267687","codeValueType":"DIGICODE","displayType":"TEXT"},{"codeValue":"|010555303610000 0000009329267687 0000009329267687 230","codeValueType":"QRCODE","displayType":"IMAGE"},{"codeValue":"|010555303610000 0000009329267687 0000009329267687 230","codeValueType":"BARCODE","displayType":"IMAGE_CONVERT"}],"paymentCodeInfoType":"PAYMENT_CODE"}]}",
"paymentAmount": {
"currency": "THB",
"value": "230"
},
"paymentCreateTime": "2024-03-22T00:39:57-07:00",
"paymentId": "20240322194010800100188320212542447",
"paymentRequestId": "PAY_20240322153955201",
"redirectActionForm": {
"method": "GET",
"redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=4HIDfStAMG1yCZHsP6XM0ml9aSsEwkMet7ZAKzCjP3s%3D&clientId=5Y607N2YJU8006726"
},
"result": {
"resultCode": "PAYMENT_IN_PROCESS",
"resultMessage": "payment in process",
"resultStatus": "U"
}
}Founded in 1907 by the Royal Charter of Thailand, Siam Commercial Bank (SCB) is the first bank in Thailand. SCB is the world's leading universal banking group and has the highest market capitalization in Thailand, it is the bank with the most branches and ATMs. SCB has more than 15 million Thai users.
Properties
The properties of the SCB payment method are shown in the following table:
User experience
The following graphic shows the SCB app authorization process:
Supported online payment integrations
Antom offers a range of integration options tailored to each payment method. Each payment method may support different online payment integration options, allowing for flexibility based on your business requirements. The table below provides detailed information about the specific integrations available for each payment method: