Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

PromptPay

Promptpay 是泰国政府背景的国家网关用户可以使用泰国主流银行账户进行转账支付。

产品特性

PromptPay 的产品特性如下表所示:

支付特性

产品特性

支付方式类别

银行转账

收单机构

AlipaySG, AlipayUS

退款

商户实体位置

SG, AU, HK, US

部分退款

买家所在国家/地区

泰国

退款周期

支付币种

THB

退款结果返回时效

支付流程

扫码

支付结果返回时效

实时

最小支付金额

0.01 THB

拒付/争议

最大支付金额

9,999,999,999.99 THB

是否支持自定义关单

✔️

用户体验

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

下图展示了应用程序终端的用户体验。

image.png

  1. 用户选择 PromptPay 进行支付。
  2. 用户获取支付码。
  3. 用户手动打开银行应用程序并点击银行页面上的 扫描
  4. 用户确认交易信息。
  5. 用户跳转到商家结果页。

集成注意事项

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

关于 normalUrl

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

支付后

  • 此支付方式仅支持离线 ATM 转账,您需要为买家提供离线支付的指导。
  • 此支付方式不支持退款,建议直接与买方线下交流
  • 您可以通过 支付通知支付结果查询 获取支付结果,并及时处理支付结果页面的跳转和显示,避免重复支付。

默认关单时间

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

响应示例

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

copy
{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=jNWtKr1NuNslNZI9bMSfKlezbo6TU5Z8Vc4r0js%2BJqk%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=eZhzE9rX8OM9t%252Fce8MFMfc0Dx0u3wBVn3oCmdfp9qqrzkmP37J40Gk5IIIFnjCZP7P7w4G3%252BmQVNKCjO%252B6j1F4UewQGtMv5Nq4pKsB4re6jQ6vZzUsqePuN5zzVMF32CJpI5a0CbtXinyDmKB5Eij4p%252FiV7a2pOHaJcApShfBb86Sni27fd%252FsWj%252FvtEpLV5pNqIJrr6kX9mFmR3KMLTnpoE8zlt04rcpE2nF8iObXx%252FGmneNcwctjLwNw46pJSBbn%252FPP9v5OfXs9kzzpO967gijOE8PalKQKBSq4M16fsjc%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            }
        ],
        "expireTime": "2024-03-13T23:08:10-07:00"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1710396490000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"00020101021230650016A00000067701011201150105552061356500209111175911030924461022052047399530376454043.005802TH5925EMVQR - AliPay Singapore 6007Bangkok62550109111175911050911117591107011082020240314909804823525630474C3\",\"codeValueType\":\"QRCODE\",\"displayType\":\"IMAGE\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "THB",
        "value": "300"
    },
    "paymentCreateTime": "2024-03-13T22:54:10-07:00",
    "paymentId": "20240314194010800100188980210741856",
    "paymentRequestId": "PAY_20240314135409345",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=jNWtKr1NuNslNZI9bMSfKlezbo6TU5Z8Vc4r0js%2BJqk%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}