Antom, leading provider of tailored payment solutions

Kbank

Kasikorn Bank(简称 Kbank)是泰国第四大商业银行,其前身为 1945 年 6 月 8 日成立的泰国农民银行,1976 年在泰国证券交易所上市,是泰国第一家提供电子支付的银行。

Kbank 在泰国拥有 1,700 万泰国用户,是最早转型电子支付的银行,支持两种不同的支付方式:网银转账和通过线下 ATM 进行银行转账。

产品特性

Kbank 根据不同支付方式类别的产品特性如下表所示:

支付方式类别

网银转账

收单机构

AntomSG, AntomHK,

AntomUS, AntomUK, AntomEU

退款

❌
商户实体位置

SG, HK, US, UK, EEA

部分退款

❌

买家所在国家/地区

泰国

退款周期

❌

支付币种

THB

退款结果返回时效

❌

支付流程

跳转

支付结果返回时效

实时

最小支付金额

1 THB

拒付/争议

❌

最大支付金额

5,000,000 THB

默认关单时间

14 分钟

支付方式类别

银行转账

收单机构

AntomSG, AntomHK,

AntomUS, AntomUK, AntomEU

退款

❌
商户实体位置

SG, HK, US, UK, EEA

部分退款

❌

买家所在国家/地区

泰国

退款周期

❌

支付币种

THB

退款结果返回时效

❌

支付流程

跳转

支付结果返回时效

实时

最小支付金额

1 THB

拒付/争议

❌

最大支付金额

5,000,000 THB

默认关单时间

48 小时

是否支持自定义关单

✔️

用户体验

注意:以下不同终端的支付流程代表该支付方式在不同终端类型上的流程,仅供参考。关于支持的商户终端类型,请咨询 Antom 技术支持。

下图展示了 App 终端在不同场景下的用户体验。

image.png

  1. 买家选择 Kbank 进行支付。
  2. 买家输入电话号码继续支付。
  3. 买家接收到账单通知后点击通知来调用银行应用。
  4. 买家在银行应用上输入 PIN。
  5. 买家确认订单信息。
  6. 买家跳转回商户结果页面。

image.png

image.png

  1. 买家选择 Kbank 进行支付。
  2. 买家跳转到付款码页面。
  3. 买家手动打开银行应用。
  4. 买家在银行页面支付订单账单。
  5. 买家在银行页面查找账单码。
  6. 买家输入银行账号和付款码。
  7. 买家确认订单信息。
  8. 银行页面展示支付结果。
  9. 买家手动跳转回商户结果页面并获取支付结果。

支持的线上支付集成

Antom 提供了一系列针对每种支付方式量身定制的集成选项。每种支付方式可能支持不同的线上支付集成选项,可根据您的业务需求进行灵活配置。下表提供了有关每种支付方式可用的特定集成的详细信息:

支持的线上支付产品

支持的集成

单笔支付

✔️ API-only 集成

✔️ 托管式 Checkout Page 集成

✔️ 嵌入式 Checkout Page 集成

✔️ Web Element

✔️ Mobile Element

❌ 链接支付

令牌支付

❌

订阅支付

❌

快捷支付

❌

扫码签约

❌

集成注意事项

以下部分概述了不同支付方式的集成考虑,详细介绍了定制化的集成解决方案和支付方式的特点。

关于 normalUrl

  • 对于 Web/WAP/App 终端,normalUrl 会在 pay(单笔支付)接口的响应中返回。买家会跳转到 normalUrl 指定的地址,并使用页面上显示的付款码继续支付。买家可以直接扫描二维码进行支付,也可以在 KPLUS 应用中输入电话号码进行支付。买家在手机上完成支付后,中间页面会自动跳转到支付方式结果页和商户结果页。
  • 不同的终端类型在返回 normalUrl 时有特定的集成特性:
  • WAP:返回的 normalUrl 会包含付款码和支付操作展示的页面。买家复制付款码,并根据页面上的支付操作指引或截图,在手机银行应用或者离线 ATM 上完成支付。
  • App:返回的 normalUrl 不会触发支付方式应用。建议您在商户应用内部直接渲染链接页面,并提供支付操作指引来指导买家完成支付。

支付后

  • 买家在银行应用中完成支付后,银行应用不会自动跳转到商户结果页面,需买家手动导航到交易发起的应用中(商户应用或浏览器)。
  • 该支付方式不支持退款,建议直接线下联系买家。

默认关单时间

当 Web 和 WAP 终端上的支付链接返回时,如果买家手动刷新页面,订单页面将重新开始 15 分钟的倒计时,这可能会导致 Antom 关闭订单时,买家仍能够完成支付,导致潜在的单边账情况。

关于 normalUrl

  • 在使用 Kbank支付时,您可以可以选择是否使用 normalUrl: 
  • 如果您不使用 normalUrl,则可以直接在商户页面上渲染接口响应中的 codeValue 来显示二维码或付款码,这样可以减少页面跳转,提升支付体验。
  • 如果您选择使用 normalUrl,买家则会跳转到由 normalUrl 指定的地址,并按照用户体验部分指引的流程进行支付。
  • 对于 Web/WAP/App 终端,normalUrl 会在 pay(单笔支付)接口的响应中返回。买家会跳转到由 normalUrl 指定的地址,并使用页面上显示的付款码在手机银行应用或者离线 ATM 设备上进行支付。支付完成后,页面会自动跳转到商户结果页面。
  • 不同的终端类型在返回 normalUrl 时有特定的集成特性。
  • WAP:返回的 normalUrl 会包含付款码和支付操作展示页面。买家复制付款码,并根据页面上的支付操作指引或截图,在手机银行应用或者离线 ATM 上完成支付。
  • App:返回的 normalUrl 不会触发支付方式应用。建议您在商户应用内部直接渲染链接页面,并提供支付操作指引来指导买家完成支付。

支付后

  • 买家在银行应用中完成支付后,银行应用不会自动跳转到商户结果页面,需买家手动导航到交易发起的应用中(商户应用或浏览器)。
  • 此支付方式不支持退款,建议直接与买方线下交流。
  • 您可以通过 notifyPayment 或 inquiryPayment 获取支付结果,并及时处理支付结果页面的跳转和显示,避免重复支付。

默认关单时间

Antom 返回的二维码不会自动刷新。 当二维码展示时,您可以使用在 pay(单笔支付)接口响应中返回的 expireTime 参数值来显示支付超时时间。当付款码展示时,您可以启用付款码的复制功能,方便买家将付款码粘贴到支付方式应用中。

响应示例

以下是支付响应中的示例代码:

json
{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=RZkKcQgoYD8iEO36wsyCbhH5sjPsJXKtxsfmjToLRMA%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "7960076110",
                "displayType": "TEXT"
            },
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252BptvV0j0OcEcUND44fbyP5nawtp%252FxTy%252Bcmu3nx3R8K3ICEo8GiuNsBxs0vnSDXR0OGKg%253D%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            },
            {
                "codeValue": "|010555303610000 0000007960076110 0000007960076110 160",
                "displayType": "TEXT"
            }
        ],
        "expireTime": "2024-04-24T22:43:25-07:00"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1714023805000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"7960076110\",\"codeValueType\":\"DIGICODE\",\"displayType\":\"TEXT\"},{\"codeValue\":\"|010555303610000 0000007960076110 0000007960076110 160\",\"codeValueType\":\"QRCODE\",\"displayType\":\"IMAGE\"},{\"codeValue\":\"|010555303610000 0000007960076110 0000007960076110 160\",\"codeValueType\":\"BARCODE\",\"displayType\":\"IMAGE_CONVERT\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "THB",
        "value": "160"
    },
    "paymentCreateTime": "2024-04-22T22:43:25-07:00",
    "paymentId": "20240423194010800100188950218781738",
    "paymentRequestId": "PAY_20240423134324142",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=RZkKcQgoYD8iEO36wsyCbhH5sjPsJXKtxsfmjToLRMA%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}