前置方案

2025-08-22 03:39

在标准的集成体验中，买家需要被重定向到支付方式页面以完成某些操作，例如选择特定的银行支付方式、输入支付详情或扫描/复制支付密码。以下最佳实践指导您在页面上展示银行列表、支付详情、二维码或支付密码，从而减少支付过程中页面重定向的需要并改善用户体验。

银行前置方案
支付要素前置方案
二维码/密码前置方案

银行前置方案

在标准集成方案中，买家需要在支付方法页面上选择特定的在线银行选项，然后被重定向到在线银行页面。然而，这个过程可能耗时且常常导致更高的买家流失率。银行前置方案在商户页面选择银行后直接跳转至银行页面，而非跳转到 Antom 中间页选择具体银行后再跳转银行，优化了网银转账的支付体验。

用户体验

此前置功能支持在 Web、WAP 和 App 上集成。下图比较了在商户 App 端的标准解决方案与使用 Przelewy24 支付方式的优化解决方案的用户体验。

标准解决方案

优化解决方案

商户页面：选择支付方式。

Antom 中间页：选择具体银行。

银行页面：完成支付。

商户页面：选择支付方式和具体银行。

银行页面：完成支付。

表1. 标准解决方案与银行前置方案的用户体验比较

标准解决方案与优化解决方案之间的区别：

标准解决方案：买家需要跳转到一个中间的 Przelewy24 页面来选择特定的银行。
优化解决方案：买家可以直接在商户页面上选择银行，无需跳转到中间的 Przelewy24 页面，减少了买家流失。

集成考虑因素

此解决方案的集成步骤与标准集成流程一致，只需要对接口的输入和输出参数进行少量调整。

在调用咨询接口获取支付方式列表时，对于支持银行前置方案的支付方式，paymentOptionDetail 字段会返回 supportBanks 列表。以 Przelewy24 支付方式为例，该支付方式可用的银行列表将显示在 paymentOptionDetail.supportBanks 的 bankIdentifierCode 和 bankShortName 的子参数中。此外，您可以联系 Antom 技术支持获取相应的 logo。
调用 支付（收银台）接口时，需要传递支付方式并指定银行。例如，对于 Przelewy24 支付方式，如果买家在 Przelewy24 下选择了 ING Bank Śląski 银行，你需要在 支付（收银台）接口的输入中包含以下参数：

paymentMethod.paymentMethodType：P24
paymentMethod.paymentMethodMetaData.bankIdentifierCode：49

以下为代码示例：

copy
"paymentMethod": {
        "paymentMethodType": "P24",
        "paymentMethodMetaData": {
            "bankIdentifierCode": "49"
        }
    }

支持的支付方式

下表列出了银行前置方案支持的支付方式枚举值、银行名称缩写和具体银行的枚举值。

支付方式	支付方式枚举值	银行名称缩写	具体银行枚举
支付方式	paymentMethodType	bankShortName	bankIdentifierCode
FPX	`ONLINEBANKING_FPX`	`Maybank`	`MYM2U`
		`Bank Islam`	`MYBISM`
		`RHB Bank`	`MYRHB`
		`Hong Leong Bank`	`MYHLB`
		`CIMB Bank`	`MYCIMBCLICKS`
		`AmBank`	`MYAMB`
		`Public Bank`	`MYPBB`
		`Affin Bank`	`MYABB`
		`Agro Bank`	`MYAGB`
		`Alliance Bank`	`MYABMB`
		`Bank Muamalat`	`MYBMMB`
		`Bank of China`	`MYBOC`
		`Bank Rakyat`	`MYBKRM`
		`Bank Simpanan Nasional`	`MYBSN`
		`HSBC Bank`	`MYHSBC`
		`Kuwait Finance House`	`MYKFH`
		`OCBC Bank`	`MYOCBC`
		`Standard Chartered Bank`	`MYSCB`
		`UOB Bank`	`MYUOB`
Przelewy24	`P24`	`Santander-Przelew24`	`20`
		`Pay with Inteligo`	`26`
		`Płacę z iPKO (PKO BP)`	`31`
		`BNP Paribas`	`33`
		`Bank PEKAO S.A`	`43`
		`Credit Agricole`	`45`
		`ING Bank Śląski`	`49`
		`Konto Inteligo`	`52`
		`Bank PKO BP (iPKO)`	`53`
		`Santander`	`54`
		`Toyota Bank`	`64`
		`Bank PEKAO S.A.`	`65`
		`Volkswagen Bank`	`69`
		`Bank Millennium`	`85`
		`Pay with Alior Bank`	`88`
		`Nest Bank`	`90`
		`Credit Agricole`	`95`
		`Pay with BOŚ`	`99`
		`Pay with ING`	`112`
		`Pay with CitiHandlowy`	`119`
		`Alior - Raty`	`129`
		`Pay with Plus Bank`	`131`
		`mBank - Raty`	`136`
		`e-transfer Pocztowy24`	`141`
		`Banki Spółdzielcze`	`143`
		`Bank Nowy BFG S.A.`	`144`
		`Getin Bank`	`153`
		`BLIK`	`154`
		`Noble Pay`	`158`
		`Pay with IdeaBank`	`161`
		`NestPrzelew`	`222`
		`BNP Paribas Płacę z Pl@net`	`223`
		`mBank - mTransfer`	`243`
		`P24now`	`266`
		`mBank (PIS)`	`270`
		`ING Bank Śląski (PIS)`	`271`
		`BNP Paribas (PIS)`	`272`
		`Bank PKO BP (PIS)`	`274`
		`Santander (PIS)`	`275`
		`Konto Inteligo (PIS)`	`279`
		`Alior Bank (PIS)`	`280`
Pay by bank	`ONLINEBANKING_YAPILY`	`monzo_ob`	`monzo_ob`
		`santander_uk`	`santander_uk`
		`hsbc_uk`	`hsbc_uk`
		`lloyds`	`lloyds`
		`revolut`	`revolut`
		`barclays`	`barclays`
		`natwest`	`natwest`
		`nationwide`	`nationwide`

表2. 银行前置方案支持的支付方式

支付要素前置方案

在标准集成方案中，买家需要在完成支付前导航到支付方式页面输入支付要素（如登录凭据、动态密码等）。然而这个过程可能耗时且常常导致更高的买家流失率。为了避免这种情况，此方案允许买家在商户页面输入买家移动账户、支付密码、邮箱和个人税号后，直接跳转至支付方式页面或收到手机推送通知，而非跳转到 Antom 中间页采集买家支付信息后再跳转至支付方式页面，可消除重定向需求，减少买家流失。

用户体验

这种前置功能也支持在 Web、WAP 和 App 上集成。下图比较了在商户 App 端的标准解决方案和使用 Pay-easy 支付方式的优化解决方案的用户体验。

标准解决方案

优化解决方案

商户页面：选择支付方式。

Antom 中间页：输入买家信息。

银行页面：完成支付。

商户页面：选择支付方式和输入买家信息。

银行页面：完成支付。

表3. 标准解决方案与支付要素预加载解决方案的用户体验比较

标准解决方案与优化解决方案的区别：

标准解决方案：买家需要跳转到一个中间的 Antom 页面输入自己的 Pay-easy 账户信息。
优化解决方案：买家可以直接在商户页面上输入账户信息，无需跳转到中间的 Antom 页面，减少了买家流失。

集成考虑因素

该解决方案的集成步骤与标准集成流程一致，只需进行少量调整以注意：

在调用 支付（收银台）接口时，需要传入支付方式和买家信息。例如，对于 Pay-easy 支付方式，如果买家在商户页面的 Pay-easy 下输入了个人信息，您需要在 支付（收银台）接口中包含以下参数：

copy
"buyer": {
  "buyerEmail": "gaga@gaga.com",
  "buyerName": {
    "firstName": "lady",
    "lastName": "gaga"
  },
  "buyerPhoneNo": "12345678901"
}

支持的支付方式

下表列出了支付要素前置方案支持的支付方式、需收集的支付要素、支付要素对应的参数名称以及实现此解决方案的最佳实践。

支付方式	收集支付要素	支付要素参数名	最佳实践
OVO	OVO 移动账户	order.buyer.buyerPhoneNo	引导买家在商户页面输入他们的 OVO 移动账户，建议提示信息：请手动打开 OVO 应用并在 55 秒内完成支付。
BLIK	BLIK 6位动态密码客户端设备IP地址买家浏览器代理信息	paymentMethodMetaData.blikCode env.clientIp env.browserInfo.userAgent	引导买家在商户页面上输入 BLIK 码，建议提示信息：如何获取 BLIK 码：请在 BLIK 应用中查找 BLIK 码；如何支付：手动打开 BLIK 应用，并在 15 秒内完成支付。
Przelewy24	买家邮箱	paymentMethodMetaData.payerEmail	引导买家在商户页面输入邮箱，或使用之前存储的买家邮箱。使用支付接口返回的支付方式链接将买家重定向到支付页面。
Mercado Pago（巴西）	巴西个人税号	paymentMethodMetaData.cpf	引导买家在商户页面输入巴西个人税号，并手动打开 Mercado Pago 应用完成支付。
Mercado Pago （巴西、墨西哥、智利和秘鲁）	买家的电子邮件	paymentMethodMetaData.payerEmail	引导买家在商户页面输入电子邮件，并手动打开 Mercado Pago 应用来完成支付。
BANCOMAT Pay	BANCOMAT Pay 移动账户	order.buyer.buyerPhoneNo	引导买家在商户页面输入他们的 BANCOMAT Pay 移动账号，建议提示信息：仅支持欧盟地区的手机号码注册 Bancomat Pay，手机格式为 +39******，不超过 20 字符。
Pay-easy	买家姓名、电话和邮箱	order.buyer.buyerName.firstName order.buyer.buyerName.lastName order.buyer.buyerEmail order.buyer.buyerPhoneNo	引导买家在商户页面输入个人信息：姓名、电话和电子邮箱。
konbini	买家姓名、电话、邮箱和便利店名称	order.buyer.buyerName.firstName order.buyer.buyerName.lastName order.buyer.buyerEmail order.buyer.buyerPhoneNo paymentMethod.paymentMethodMetaData.storeName	引导买家在商户页面输入个人信息：姓名、电话、电子邮箱和选择的便利店。
Konbini (7-Eleven)	买家姓名、电话和邮箱	order.buyer.buyerName.firstName order.buyer.buyerName.lastName order.buyer.buyerEmail order.buyer.buyerPhoneNo	引导买家在商户页面输入个人信息：姓名、电话和电子邮箱。

表4. 支付要素前置方案支持的支付方式。

二维码/密码前置方案

在标准集成方案中，买家需要导航到支付方式页面扫描二维码或输入支付密码来完成支付。然而，这个过程可能耗时，并且常常导致较高的买家流失率。为了解决这个问题，你可以在商户页面上显示支付二维码或支付密码，减少重定向的需要，降低买家流失。

用户体验

此前置功能支持在 Web、WAP 和 App 上集成。下图比较了在商户 Web 端使用 AlipayHK 支付方式的二维码前置模式，以及在商户 App 端使用银行转账支付方式的密码前置模式时的用户体验、最佳实践以及标准和优化的解决方案。

前置模式

标准解决方案

优化解决方案

最佳实践

二维码前置方案

建议您指定参数 orderCodeForm.expireTime 以设置超时时间，并在商户页面上显示支付二维码的倒计时。

建议使用浮层来显示支付二维码。

对于 AlipayHK、Alipay、GCash、Touch'n Go eWallet、Kakao Pay、LINE Pay、TrueMoney 支付方式，需要按照品牌规范在浮层中展示二维码，并在代码页面底部显示“powered by A+”。

QRIS、PayNow 和 PromptPay 的支付方式在 Web、WAP 和 App 三个平台上都有扫码体验，您可以在所有三个平台上为这些支付方式提供此功能。

对于其他支付方式，建议仅在 Web 上显示二维码，而在 WAP 和 App 上使用唤起 App 支付或密码支付体验。

密码前置方案

建议您指定参数 orderCodeForm.expireTime 以设置超时时间，并在商户页面上显示支付二维码的过期倒计时。

建议使用浮层展示支付密码。浮层支持买家复制密码，并为买家提供操作提示。

表5. 标准解决方案与二维码/密码前置方案的用户体验比较

标准解决方案与优化解决方案之间的差异：

标准解决方案 ：买家需要跳转到一个中间的 Antom 页面来扫描二维码或获取密码。
优化解决方案 ：买家可以直接在商户页面上扫描二维码或获取密码，无需跳转到中间的 Antom 页面，减少了买家流失。

集成考虑因素

尽管此解决方案的集成步骤与标准集成过程一致，但需要注意以下关键差异：

在支付请求的响应中，可以通过 orderCodeForm.codeDetails.codeValue 字段获取支付二维码或支付口令。支付二维码支持文本格式，将以 TEXT/BIGIMAGE/MIDDLEIMAGE/SMALLIMAGE 类型展示，而支付口令将以 TEXT 格式提供（当 TEXT 类型为链接时，表示二维码需要您单独处理）。您需要根据实际需求，在自己的页面上显示支付二维码或支付口令，并根据 orderCodeForm.expireTime 字段展示过期时间。当买家支付完成后，由商户端控制跳转到支付结果页，以确保买家可以及时查看支付状态。

以下为代码示例：

copy
"orderCodeForm": {
    "codeDetails": [
      {
        "codeValue": "5461581653",
        "displayType": "TEXT"
      },
      {
        "codeValue": "https://global.alipay.com/merchant/order/showQrImage.htm?code=https%3A%2F%2Fglobal.alipay.com%2F281002040091leOl1lerj31tHD30nPg8YNIS&picSize=L",
        "displayType": "BIGIMAGE"
      },
      {
        "codeValue": "https://global.alipay.com/merchant/order/showQrImage.htm?code=https%3A%2F%2Fglobal.alipay.com%2F281002040091leOl1lerj31tHD30nPg8YNIS&picSize=M",
        "displayType": "MIDDLEIMAGE"
      },
      {
        "codeValue": "https://global.alipay.com/merchant/order/showQrImage.htm?code=https%3A%2F%2Fglobal.alipay.com%2F281002040091leOl1lerj31tHD30nPg8YNIS&picSize=S",
        "displayType": "SMALLIMAGE"
      },
      {
        "codeValue": "|010555303610000 0000005461581653 0000005461581653 3500",
        "displayType": "TEXT"
      }
    ],
    "expireTime": "2025-03-27T23:26:06-07:00"
  },

支持的支付方式

下表显示了二维码/密码前置方案支持的支付方式以及推荐的商户端实现类型。

前置类型	支持的支付方式	推荐的商户端实现类型
二维码前置方案	QRIS, PayNow, PromptPay, Konbini	Web, WAP, App
二维码前置方案	AlipayHK, Alipay, GCash, Touch'n Go eWallet, Kakao Pay, LINE Pay, TrueMoney, ShopeePay, Pay by bank	Web
密码前置方案	Pix	Web, WAP, App
	Maybank
	BNI
	Permata
	CIMB Niaga VA
	BSI
	ATM Bersama/Prima/Alto
	Bangkok Bank
	Siam Commercial Bank
	Bank of Ayudhya
	Krungthai Bank
	Kbank
	Government Savings Bank

表6. 二维码和密码前置方案支持的支付方式

注意：支付方式 Pay by bank 需要先实现银行前置，Antom 才会返回各银行的二维码。