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:
| 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 |
{
"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"
}{
"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"
}{
"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"
}{
"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": ""
}{
"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"
}{
"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"
}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 |
{
"resCode": "00",
"resDesc ": "success",
"transactionId": "xxx",
"confirmId" : "xxx"
}Please check the latest Bank Code from BOT website. The detail will be in "รหัสสถาบันการเงิน (Financial Institution Code)" table.