Antom, leading provider of tailored payment solutions

Bank of Ayudhya

Bank of Ayudhya (BAY) 由中国商人陈功坤于 1945 年创立。 BAY 是泰国第五大商业银行,拥有 601 家国内分支机构和超过 540 万泰国用户。 目前,银行支持两种不同的方式支付:网银转账和通过线下 ATM 机的银行转账。

产品特性

下表根据不同的支付方式类别展示了 BAY 的产品特性:

支付方式类别

网银转账

收单机构

AntomSG, AntomHK, AntomUS, AntomUK, AntomEU

退款

❌
商户实体位置

SG, HK, US, UK, EEA

部分退款

❌

买家所在国家/地区

泰国

退款周期

❌

支付币种

THB

退款结果返回时效❌

支付流程

跳转

支付结果返回时效

实时

最小支付金额

1 THB

拒付/争议

❌
最大支付金额2,000,000 THB

默认关单时间

14 分钟

支付方式类别

银行转账

收单机构

AntomSG, AntomHK, AntomUS, AntomUK, AntomEU

退款

❌
商户实体位置

SG, HK, US, UK, EEA

部分退款

❌

买家所在国家/地区

泰国

退款周期

❌

支付币种

THB

退款结果返回时效❌

支付流程

跳转

支付结果返回时效

实时

最小支付金额

1 THB

拒付/争议

❌
最大支付金额

2,000,000 THB

(ATM: 500,000 THB)

默认关单时间

48 小时

是否支持自定义关单

✔️

用户体验

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

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

Bank of Ayudhya.png

  1. 买家选择 BAY 进行支付
  2. 买家在 BAY 页面完成支付。
  3. 买家跳转回商户结果页。

Bank of Ayudhya.png

  1. 买家选择 BAY 进行支付。
  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 时有特定的集成特性:

  • Web:在返回的 normalUrl 中输入用户名和密码进行支付。
  • WAP:在返回的 normalUrl 中输入用于支付的电子邮件/电话号码和 PIN。买家跳转到银行支付页面,然后通过账号密码登录完成支付。
  • App:返回的 normalUrl 不会触发支付方式应用。建议您在商户应用内直接渲染银行中间页链接,然后将商户结果页面设置为浏览器链接而不是 App scheme。如果您使用外部跳转来打开银行中间页链接,应将商户结果页设置为商户应用 scheme,或者将浏览器链接跳转到 scheme 或 deeplink。

支付后

  • 该支付方式不支持退款,建议直接线下联系买家。
  • 当买家选择网银转账方式进行支付时,银行会向买家收取每笔交易的手续费。关于手续费的具体金额,请咨询银行了解详细信息。

默认关单时间

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

关于 normalUrl

  • 在使用 BAY 支付时,您可以可以选择是否使用 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 参数值来显示支付超时时间。当付款码展示时,您可以启用付款码的复制功能,方便买家将付款码粘贴到支付方式应用中。

响应示例

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

json
{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=zuibI4qw6WGRJjuoXTIlWyW0%2FeQjFnQbRZ9%2FdTSmBd0%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "5680439345",
                "displayType": "TEXT"
            },
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252BpttJpB%252F3RD%252FE7y3BPsxndnO1ZtFvqKbWLhmJGBbvT0j8sCTreuv81tr70GRqAcvEoEw%253D%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            },
            {
                "codeValue": "|010555303610000 0000005680439345 0000005680439345 220",
                "displayType": "TEXT"
            }
        ],
        "expireTime": "2024-04-24T22:33:03-07:00"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1714023183000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"5680439345\",\"codeValueType\":\"DIGICODE\",\"displayType\":\"TEXT\"},{\"codeValue\":\"|010555303610000 0000005680439345 0000005680439345 220\",\"codeValueType\":\"QRCODE\",\"displayType\":\"IMAGE\"},{\"codeValue\":\"|010555303610000 0000005680439345 0000005680439345 220\",\"codeValueType\":\"BARCODE\",\"displayType\":\"IMAGE_CONVERT\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "THB",
        "value": "220"
    },
    "paymentCreateTime": "2024-04-22T22:33:03-07:00",
    "paymentId": "20240423194010800100188430219079465",
    "paymentRequestId": "PAY_20240423133301010",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=zuibI4qw6WGRJjuoXTIlWyW0%2FeQjFnQbRZ9%2FdTSmBd0%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}