Bangkok Bank (简称BBL) 是一家泰国商业银行。 BBL 成立于 1944 年,1975 年在泰国证券交易所上市。 它是亚洲第六大银行,也是泰国三大银行之一。
BBL 拥有 1070 万多个泰国用户。 目前,银行支持两种不同的方式为用户支付:网上银行和通过线下 ATM 机的银行转账。
产品特性
下表根据不同的支付方式类别展示了 BBL 的产品特性:
用户体验
注意:以下不同终端的支付流程代表该支付方式在不同终端类型上的流程,仅供参考。关于支持的商户终端类型,请咨询 Antom 技术支持。
下图展示了不同场景下 BBL 的用户在 WAP 终端的体验。
- 用户选择使用 BBL 进行支付。
- 用户输入账户 ID 和密码进行支付。
- 用户跳转回商家页面。
- 用户选择使用 BBL 进行支付。
- 用户跳转到付款码页面。
- 用户输入 PIN。
- 用户进入账单支付页面。
- 用户确认支付。
- 用户跳转回商家页面。
集成注意事项
以下部分概述了不同支付方式的集成考虑,详细介绍了定制化的集成解决方案和支付方式的特点。
关于 normalUrl
对于 Web,WAP 和 App 终端,normalUrl 会在 支付 接口的响应中返回。 不同的终端类型在返回 normalUrl 时有特定的集成特性:
- WAP:返回的 normalUrl 是一个浏览器链接。买家跳转到银行支付页面,然后通过账号密码登录完成支付。
- App:返回的 normalUrl 不会触发支付方式应用。建议您在商家 App 内直接渲染银行中间页链接,然后将商家结果页面设置为浏览器链接而不是 App scheme。如果您使用外部跳转来打开银行中间页链接,应将商户结果页设置为商家 App scheme,或者将浏览器链接跳转到 scheme 或 deeplink。
支付后
该支付方式不支持退款。建议直接线下联系买家。
默认关单时间
如果买家未完成支付,Antom 会在 14 分钟后发送支付结果的异步通知给您。商户等待异步通知或查询结果的关单时间必须大于 14 分钟。
关于 normalUrl
- 在使用 BBL 支付时,您可以可以选择是否使用 normalUrl:
- 如果您不使用 normalUrl,则可以直接在商户页面上渲染接口响应中的 codeValue 来显示二维码或付款码,这样可以减少页面跳转,提升支付体验。
- 如果您选择使用 normalUrl,买家则会跳转到由 normalUrl 指定的地址,并按照用户体验部分指引的流程进行支付。
- 对于 Web、WAP 和 App 终端,normalUrl 会在 支付 接口的响应中返回。买家会跳转到由 normalUrl 指定的地址,并使用页面上显示的付款码在离线 ATM 设备上进行支付。支付完成后,页面会自动跳转到商户结果页面。
- 不同的终端类型在返回 normalUrl 时有特定的集成特性。
- WAP:返回的 normalUrl 会包含付款码和支付操作展示的页面。买家复制付款码,并根据页面上的支付操作指引或截图,在离线 ATM 上完成支付。
- App:返回的 normalUrl 不会触发支付方式应用。建议您在商户应用内部直接渲染链接页面,并提供付款操作指引来指导买家完成支付。
支付后
- 此支付方式仅支持离线 ATM 转账,您需要为买家提供离线支付的指导。
- 此支付方式不支持退款,建议直接与买方线下交流。
- 您可以通过 支付通知 或 支付结果查询 获取支付结果,并及时处理支付结果页面的跳转和显示,避免重复支付。
默认关单时间
Antom 返回的二维码不会自动刷新。 当二维码展示时,您可以在接口响应中添加 expireTime 参数以显示超时时间。当付款码展示时,您可以启用付款码的复制功能,方便买家将付款码粘贴到支付方式应用中。
响应示例
以下是支付响应中的示例代码:
{
"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"
}
}