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

BNI

印尼国家银行(Bank Negara Indonesia,简称 BNI), 属印尼最大银行。允许用户使用银行转账和在线网银的方式完成支付。

产品特性

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

支付特性

产品特性

支付方式类别

银行转账

收单机构

AlipaySG, AlipayUS

退款

商户实体位置

SG, AU, HK, US

部分退款

买家所在国家/地区

印度尼西亚

退款周期

支付币种

IDR

退款结果返回时效

支付流程

跳转

支付结果返回时效

实时

最小支付金额

10,000 IDR

拒付/争议

最大支付金额1,000,000,000 IDR是否支持自定义关单

✔️

用户体验

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

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

image.png

  1. 用户选择 BNI 进行支付。
  2. 用户跳转到付款码页面并复制付款码。
  3. 用户手动打开 BNI 移动银行应用并登录。
  4. 用户选择 Virtual Account Billing
  5. 用户粘贴付款码。
  6. 用户输入密码并确认支付。
  7. 银行页面显示支付结果。
  8. 用户手动切换回商家结果页面。

集成注意事项

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

关于 normalUrl

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

支付后

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

默认关单时间

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

响应示例

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

copy
{
    "normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=lnqZ3nxHhMSC0%2F%2FTekZBMZliCVPrlmECiVsg0pT7zTc%3D&clientId=5Y607N2YJU8006726",
    "orderCodeForm": {
        "codeDetails": [
            {
                "codeValue": "1664464300",
                "displayType": "TEXT"
            },
            {
                "codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=3%252Fk97oupdVD%252ByBP1ou%252BptnNMUaDH4lWtB%252BzUXctrxZl0BDWJVaR2NE0Zh6Mg9tiWGZihBVFjpK3UhP%252FGBUlXxg%253D%253D&size=M&sid=188",
                "displayType": "MIDDLEIMAGE"
            }
        ],
        "expireTime": "2024-03-21T01:12:04-07:00"
    },
    "paymentActionForm": "{\"paymentActionFormType\":\"PaymentCodeForm\",\"paymentCodeExpireTime\":1711008724000,\"paymentCodeInfos\":[{\"paymentCodeDetails\":[{\"codeValue\":\"1664464300\",\"codeValueType\":\"DIGICODE\",\"displayType\":\"TEXT\"},{\"codeValue\":\"|010555303610000 0000001664464300 0000001664464300 3120000\",\"codeValueType\":\"QRCODE\",\"displayType\":\"IMAGE\"}],\"paymentCodeInfoType\":\"PAYMENT_CODE\"}]}",
    "paymentAmount": {
        "currency": "IDR",
        "value": "3120000"
    },
    "paymentCreateTime": "2024-03-21T00:58:04-07:00",
    "paymentId": "20240321194010800100188020212931416",
    "paymentRequestId": "PAY_202403121413461143248",
    "redirectActionForm": {
        "method": "GET",
        "redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=lnqZ3nxHhMSC0%2F%2FTekZBMZliCVPrlmECiVsg0pT7zTc%3D&clientId=5Y607N2YJU8006726"
    },
    "result": {
        "resultCode": "PAYMENT_IN_PROCESS",
        "resultMessage": "payment in process",
        "resultStatus": "U"
    }
}