Payment Confirmation

After the customer scans and pays successfully, SCB will send a payment confirmation to Merchant's registered URL. All onboarded merchants may provide a payment confirmation endpoint when creating an app.

Do note that there will be no payment confirmation sent if the payment from the customer is not successful.

Once the merchant receives the payment confirmation from SCB, the merchant needs to provide a response to the request with the format outlined in the response section below. In the case that there is no response from the merchant, SCB will re-send the payment confirmation to merchant up to 3 times, with an interval of 12 seconds in between attempts.

In the case that SCB does not get a proper response from the merchant after 3 tries, SCB will provide the transaction details to the merchant's registered e-mail.

If a merchant would like to check the transaction status, they can use the inquiry function as provided below:

Endpoint

Prerequisite

Reference Terms

Request

Name Type SCB
EASY App
Payment(BP)		 SCB
EASY App
Payment(CCFA)		 SCB
EASY App
Payment(IPP)		 QR 30 QR CS Alipay+ WeChatPay Description
transactionId String Y Y Y Y Y Y Transaction ID generated by source system
amount String Y Y Y Y Y Y Amount of Transaction
transactionDateandTime String Y Y Y Y Y Y Date and Time of transaction in ISO 8601 format
SCB EASY App Payment (BP), SCB EASY App Payment (CCFA), SCB EASY App Payment (IPP), QR30, Alipay+, WeChatPay : Time in GMT+7
QRCS : Time in GMT
currencyCode String Y Y Y Y Y Y Code to define currency for transaction based on ISO 4217 for transactionAmount. Thai Baht is ‘764’
transactionType String Y Y Y Y Y Y Type of transaction
QR30, SCB EASY App
Payment (BP) : Domestic
Transfer
SCB EASY App Payment
(CCFA), SCB EASY App Payment (IPP), QRCS, Alipay+,
WeChatPay : AUTH
merchantId String Y Y Y Y Merchant ID
terminalId String Y Y Y Y Terminal ID
qrId String Y Y Alipay+/WeChatPay : out_trade_no value when creating the QR
merchantPAN String Y Merchant PAN number from card scheme, up to 16 characters
consumerPAN String Y Y Y Customer PAN number from card scheme, up to 16 characters
traceNo String Y Y Y Running Number
authorizeCode String Y Y Y Authorization code from issuing host
payeeProxyType String Y Y PromptPay Type for QR 30,
SCB EASY App Payment (BP)
Value : BILLERID
payeeProxyId String Y Y Biller ID
payeeAccountNumber String Y Y Account Number of payee
payeeName String Y Y Name of Payee
payerProxyId String Y Y Account Number
payerProxyType String Y Y PromptPay Type for QR 30, SCB EASY App Payment (BP)
Value : ACCOUNT
payerName String Y Y Y QR 30, SCB EASY App
Payment (BP) : Name of payer
Alipay+/WeChatPay : Payer
account identification
payerAccountNumber String Y Y Account Number of payer
billPaymentRef1 String Y Y Y Y Reference 1
billPaymentRef2 String Y Y Reference 2
billPaymentRef3 String Y Y Reference 3
sendingBankCode String Y Y 3-digit bank code of payer (Refer to below section for complete bank code list)
receivingBankCode String Y Y 3-digit bank code of payee (Refer to below section for complete bank code list)
channelCode String Y Y Y Y Y Channel Code
QR30, QRCS, SCB EASY App Payment (BP) : PMH
(CS) : PMH, VISA, MASTER
SCB EASY App Payment
(CCFA) : eg. VISA, MASTER,
SCB EASY App Payment (IPP)
paymentMethod String Y Y Y Y SCB EASY App Payment
(CCFA) : CreditCard
SCB EASY App Payment (IPP) : CreditCard
QRCS : QRCS
Alipay+ : ALIPAY+
WechatPay : WECHATPAY
tenor String Y Tenor
ippType String Y Ipp type
productCode String Y Product Code
exchangeRate String Y Exchange Rate
equivalentAmount String Y Original Currency Amount
equivalentCurrencyCode String Y Original Currency Code
Chinese Yuan : 156
companyId String Y Company ID
invoice String Y Invoice or bill number for the transaction. If this is the first time generating this dynamic QR code, the invoice value entered must be unique and never been used for payment before
note String Y Description of QR transaction

Example Request

QR 30 & SCB EASY App Payment (BP)

{
  "payeeProxyId":"010556107659001",
  "payeeProxyType":"BILLERID",
  "payeeAccountNumber":"4680716512",
  "payerAccountNumber":"0662658053",
  "payerName":"อิสมาน ยูโซะ",
  "sendingBankCode":"014",
  "receivingBankCode":"014",
  "amount":"1.00",
  "transactionId":"46a0e0c00f114482991414ef26654ace",
  "transactionDateandTime":"2019-04-11T05:16:48.000+07:00",
  "billPaymentRef1":"190411VZGNEYIWD55KDD",
  "billPaymentRef2":"ESPREE",
  "billPaymentRef3":"ESP5CAE6B1B77HOCJXLZ",
  "currencyCode":"764",
  "channelCode":"PMH",
  "transactionType":"Domestic Transfers"
}

SCB EASY App Payment (CCFA)

{
  "amount": "1.0000",
  "transactionId": "46a0e0c00f114482991414ef26654ace",
  "transactionDateandTime": "2019-04-10T08:01:09.427+00:00",
  "consumerPAN": "540716xxxxxx5772",
  "currencyCode": "764",
  "transactionType": "AUTH",
  "traceNo": "014691",
  "terminalId": "57000002",
  "merchantId": "010000000002356766",
  "authorizeCode": "001ERH",
  "paymentMethod": "CreditCard",
  "billPaymentRef1": "190411VZGNEYIWD55KDD",
  "channelCode": "VISA"
}

SCB EASY App Payment (CCIPP)

{
  "amount": "1.0000",
  "transactionId": "46a0e0c00f114482991414ef26654ace",
  "transactionDateandTime": "2019-04-10T08:01:09.427+00:00",
  "consumerPAN": "540716xxxxxx5772",
  "currencyCode": "764",
  "transactionType": "AUTH",
  "traceNo": "014691",
  "terminalId": "57000002",
  "merchantId": "010000000002356766",
  "authorizeCode": "001ERH",
  "paymentMethod": "CreditCard",
  "billPaymentRef1": "190411VZGNEYIWD55KDD",
  "channelCode": "VISA",
  "tenor": "12",
  "ippType": "3",
  "productCode": "1001"
}

QR CS

{
  "amount": "1.0000",
  "transactionId": "243361",
  "transactionDateandTime": "2019-04-10T08:01:09.427+00:00",
  "merchantPAN": "5598650000204536",
  "consumerPAN": "540716xxxxxx5772",
  "currencyCode": "764",
  "transactionType": "AUTH",
  "qrId": "305408",
  "terminalId": "57000002",
  "merchantId": "010000000002356766",
  "traceNo": "014691",
  "authorizeCode": "001ERH",
  "paymentMethod": "QRCS",
  "channelCode": "VISA",
  "invoice": "1234",
  "note": ""
}

Alipay

{
  "payerName": "int***@service.*",
  "amount": "1.00",
  "transactionId": "2019041022001460421025418283",
  "transactionDateandTime": "2019-04-10T16:22:53+07:00",
  "currencyCode": "764",
  "transactionType": "AUTH",
  "qrId": "65001195143542737928",
  "terminalId": "65001195",
  "merchantId": "2300060",
  "paymentMethod": "ALIPAY",
  "exchangeRate": "0.21169846",
  "equivalentAmount": "0.21",
  "equivalentCurrencyCode": "156",
  "companyId": "004"
}

Alipay+

{
  "amount" : "1111",
  "transactionId" :"20241009190741010008C0006952401",
  "transactionDateandTime" : "2024-10-09T11:49:26+07:00",
  "currencyCode" : "764",
  "transactionType" : "AUTH",
  "qrId" :"TRANSACTIONREFERENCE89",
  "terminalId" : "77772431",
  "merchantId" : "0912180",
  "paymentMethod" : "ALIPAYPLUS",
  "exchangeRate" : "0",
  "equivalentAmount" : "1111",
  "equivalentCurrencyCode" : "156",
  "companyId" : "001"
}

WeChatPay

{
  "payerName": "oGxrV0QJzbqTX3hDi7WE9d35_Q4I",
  "amount": "1",
  "transactionId": "4200000287201904104686653117",
  "transactionDateandTime": "2019-04-10T16:19:04+07:00",
  "currencyCode": "764",
  "transactionType": "AUTH",
  "qrId": "65001195143538455980",
  "terminalId": "65001195",
  "merchantId": "2300060",
  "paymentMethod": "WECHATPAY",
  "exchangeRate": "0.2118",
  "equivalentAmount": "0.21",
  "equivalentCurrencyCode": "156",
  "companyId": "004"
}

Response

Merchant will need to provide response to SCB once payment confirmation is receive at merchant endpoint.

Name Type Description
resCode String Fix : 00
resDesc String Fix : success
transactionId String Echo "transactionId" value from Payment Confirmation
confirmId String Optional

Example Response

QR 30, QR CS, Alipay+, WeChatPay

{
  "resCode": "00",
  "resDesc ": "success",
  "transactionId": "xxx",
  "confirmId" : "xxx"
}

Bank Code

Please check the latest Bank Code from BOT website. The detail will be in "รหัสสถาบันการเงิน (Financial Institution Code)" table.