Antom, leading provider of tailored payment solutions
Contact Us
Log In

KrungThai Bank

用于单笔支付
KrungThai Bank（简称 KTB）是泰国国家控股的上市银行，实力排名泰国第二，是大多数政府机构的首选银行。KTB 覆盖 1,500 万的银行用户，目前已经支持网银支付、手机支付或者去线下 ATM 网点进行支付。

产品特性

KTB 不同支付方式类别的产品特性如下表所示：
支付方式类别
网银转账
收单机构
AntomSG, AntomUS, AntomUK, AntomEU, AntomHK
退款
❌
商户实体位置
SG, US, UK, EEA, HK
部分退款
❌
买家所在国家/地区
泰国
退款周期
❌
支付币种
THB
退款结果返回时效
❌
支付流程
跳转
支付结果返回时效
实时
最小支付金额
1 THB
拒付/争议
❌
最大支付金额
2,000,000 THB
默认关单时间
14 分钟
支付方式类别
银行转账
收单机构
AntomSG, AntomUS, AntomUK, AntomEU, AntomHK
退款
❌
商户实体位置
SG, US, UK, EEA, HK
部分退款
❌
买家所在国家/地区
泰国
退款周期
❌
支付币种
THB
退款结果返回时效
❌
支付流程
跳转
支付结果返回时效
实时
最小支付金额
1 THB
拒付/争议
❌
最大支付金额
2,000,000 THB
（ATM：500,000 THB）
默认关单时间
48 小时
是否支持自定义关单
✔️

用户体验

注意：以下不同终端的支付流程代表该支付方式在不同终端类型上的流程，仅供参考。关于支持的商户终端类型，请咨询 Antom 技术支持。
下图展示了不同场景下 WAP 终端的用户体验。
网银转账
  1. 买家选择 KrungThai Bank 进行支付。
  2. 买家进入银行页面完成支付。
  3. 买家跳转至商户结果页。
银行转帐
  1. 买家选择 KrungThai Bank 进行支付。
  2. 买家跳转到付款码页面。
  3. 买家在银行应用上完成转账。
  4. 买家跳转至商户结果页。

支持的线上支付集成

Antom 提供了一系列针对每种支付方式量身定制的集成选项。每种支付方式可能支持不同的线上支付集成选项，可根据您的业务需求进行灵活配置。下表提供了有关每种支付方式可用的特定集成的详细信息：
支持的线上支付产品
支持的集成
单笔支付
✔️ API-only 集成
✔️ 托管式 Checkout Page 集成
❌ 嵌入式 Checkout Page 集成
✔️ Web Element
✔️ Mobile Element
❌ 链接支付
令牌支付
✔️ API-only 集成
订阅支付
❌
快捷支付
❌
扫码签约
❌

集成注意事项

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

关于 normalUrl

  • 对于 Web 终端，normalUrl 会在 pay（单笔支付）接口的响应中返回。买家跳转到 normalUrl 指定的地址后可直接进入银行支付页面。
  • 对于 WAP 和 App 终端，pay（单笔支付）接口的响应中会返回 normalUrl。买家跳转到 normalUrl 指定的地址后，可查看支付信息页面。买家直接在网页上输入账号 ID 和密码完成支付，或者打开 KTB 应用输入 PIN 进行支付。如果选择使用 KTP 应用进行支付，买家完成支付后，会先跳转到浏览器页面，然后返回商户结果页面。
  • App 终端返回的 URL 为银行中间页，支持买家拉起银行应用进行支付。建议您在商户应用内直接渲染银行中间页链接，并兼容 WebView 中的 applinkUrl 和 schemeUrl 能力。注意将商户结果页面设置为浏览器链接，而不是 App scheme。

支付后

  • 当在银行应用内完成支付后，买家先跳转到浏览器页面，然后再返回 paymentRedirectUrl 参数中指定的商户结果页面。
  • 该支付方式不支持退款，建议直接线下联系买家。

默认关单时间

如果买家未完成支付，Antom 会在 14 分钟后发送支付结果的异步通知给您。商户等待异步通知或查询结果的关单时间必须大于 14 分钟。
银行转帐

关于 normalUrl

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

支付后

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

默认关单时间

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

响应示例

以下是支付响应中的示例代码：
{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=1xIJp0BNA9wfWb8Ng4v8%2FgtUzIH%2BGxztrdQ0gvg9%2Ft8%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "2863326076",
                "displayType": "TEXT"
            },
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252BptkJCRdgTHHU0QwfBXR93E2TFVAOSffEVRoMAiLJdqWcGnYKBdlZvVY2lclrLtr6t8g%253D%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            },
            {
                "codeValue": "|010555303610000 0000002863326076 0000002863326076 240",
                "displayType": "TEXT"
            }
        ],
        "expireTime": "2024-03-26T23:00:08-07:00"
    },
    "paymentActionForm": "{"paymentActionFormType":"PaymentCodeForm","paymentCodeExpireTime":1711519208000,"paymentCodeInfos":[{"paymentCodeDetails":[{"codeValue":"2863326076","codeValueType":"DIGICODE","displayType":"TEXT"},{"codeValue":"|010555303610000 0000002863326076 0000002863326076 240","codeValueType":"QRCODE","displayType":"IMAGE"},{"codeValue":"|010555303610000 0000002863326076 0000002863326076 240","codeValueType":"BARCODE","displayType":"IMAGE_CONVERT"}],"paymentCodeInfoType":"PAYMENT_CODE"}]}",
    "paymentAmount": {
        "currency": "THB",
        "value": "240"
    },
    "paymentCreateTime": "2024-03-24T23:00:08-07:00",
    "paymentId": "20240325194010800100188370212989584",
    "paymentRequestId": "PAY_20240325140007809",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=1xIJp0BNA9wfWb8Ng4v8%2FgtUzIH%2BGxztrdQ0gvg9%2Ft8%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}
用于令牌支付
KrungThai Bank (KTB) 是泰国国家控股的上市银行，实力排名泰国第二，也是大多数政府机构的首选银行。 KTB 拥有 1,500 万的银行用户。

产品特性

KTB 支付方式的特性如下表所示：
支付方式类别
网银转账
收单机构
AntomSG, AntomHK, AntomUS, AntomUK, AntomEU
商户实体位置
SG, HK, US, UK, EEA
支付流程
跳转
退款
❌
买家所在国家/地区
泰国
部分退款
❌
支付币种
THB
拒付/争议
❌
最小支付金额
1 THB
支付结果返回时效
实时
最大支付金额
2,000,000 THB
(ATM: 500,000 THB)

用户体验

下图展示了 KTB 的授权过程：
  1. 买家在商户收银页面选择 KrungThai Bank 进行绑定。
  2. 买家跳转到 KrungThai Bank 页面登录账户。
  3. 买家完成绑定流程。
  4. 买家跳转回商户结果页面。

支持的线上支付集成

Antom 提供了一系列针对每种支付方式量身定制的集成选项。每种支付方式可能支持不同的线上支付集成选项，可根据您的业务需求进行灵活配置。下表提供了有关每种支付方式可用的特定集成的详细信息：
支持的线上支付产品
支持的集成
单笔支付
✔️ API-only 集成
✔️ 托管式 Checkout Page 集成
❌ 嵌入式 Checkout Page 集成
✔️ Web Element
✔️ Mobile Element
❌ 链接支付
令牌支付
✔️ API-only 集成
订阅支付
❌
快捷支付
❌
扫码签约
❌