QRPH
QRPH 是菲律宾的二维码标准。它方便、安全且经济高效，为菲律宾的各种银行或电子钱包支付提供统一标准化的二维码。QRPH 创建了一个安全、互联、无现金的系统，使人对人 (P2P) 和人对商户 (P2M) 交易变得更加容易。
产品特性
QRPH 的产品特性如下表所示：
支付方式类别 | 实时支付 | ||
收单机构 | AntomSG, AntomHK, AntomEU, AntomUS, AntomUK, AntomPH | 商户实体位置 | SG, HK, EEA, US, UK, PH |
支付流程 | 扫码 | 退款 | ❌ |
买家所在国家/地区 | 菲律宾 | 部分退款 | ❌ |
支付币种 | PHP | 拒付/争议 | ✔️ |
最小支付金额 | 20 PHP | 退款周期 | ❌ |
最大支付金额 | 9,999,999 PHP | 支付结果返回时效 | 实时 |
默认关单时间 | 14 分钟 | ||
用户体验
注意：以下不同终端的支付流程代表该支付方式在不同终端类型上的流程，仅供参考。关于支持的商户终端类型，请咨询 Antom 技术支持。
下图为使用 QRPH 支付的流程：
Web
- 买家在商户收银页面选择 QRPH 进行支付。
- 买家跳转到 Antom 收银页面，此页面会显示生成的二维码。
- 买家打开所需的银行或电子钱包应用扫描二维码。
- 买家完成授权并确认支付。
- 买家完成支付。
- 买家手动切换回商户页面以查看支付结果。
App
- 买家在商户收银页面选择 QRPH 进行支付。
- 买家跳转到 Antom 收银页面，此页面会显示生成的二维码。买家可以截图保存二维码图片。
- 买家打开所需的银行或电子钱包应用，选择保存的二维码图片进行扫描。
- 买家完成授权并确认支付。
- 买家完成支付。
- 买家手动切换回商户页面以查看支付结果。
支持的线上支付集成
Antom 提供了一系列针对每种支付方式量身定制的集成选项。每种支付方式可能支持不同的线上支付集成选项，可根据您的业务需求进行灵活配置。下表提供了有关每种支付方式可用的特定集成的详细信息：
支持的线上支付产品 | 支持的集成 |
单笔支付 | ❌ 链接支付 |
令牌支付 | ❌ |
订阅支付 | ❌ |
快捷支付 | ❌ |
扫码签约 | ❌ |
集成注意事项
以下部分概述了不同支付方式的集成考虑，详细介绍了定制化的集成解决方案和支付方式的特点。
关于 normalUrl
- 在使用 QRPH 支付时，您可以可以选择是否使用 normalUrl:
- 如果您不使用 normalUrl，则可以直接在商户页面上渲染接口响应中的 codeValue 来显示二维码，这样可以减少页面跳转，提升支付体验。
- 如果您选择使用 normalUrl，买家则会跳转到由 normalUrl 指定的地址，并按照用户体验部分指引的流程进行支付。
- 对于 Web/WAP/App 终端，normalUrl 会在 pay (单笔支付) 接口的响应中返回。买家会跳转到由 normalUrl 指定的地址，并使用页面上显示的二维码进行支付。买家通过扫码完成支付，页面会自动跳转到商户结果页面。
- 不同的终端类型在返回 normalUrl 时有特定的集成特性。
- WAP：返回的 normalUrl 会包含二维码和支付操作展示的页面。买家对二维码进行截图，再手动打开具体的支付方式应用进行扫描并支付。
- App：返回的 normalUrl 不会触发支付方式应用，建议在应用外部打开重定向 URL。
支付后
- 买家在银行应用中完成支付后，银行应用不会自动跳转到商户结果页面，需买家手动导航到交易发起的应用中（商户应用或浏览器）。
- 此支付方式不支持退款，建议直接与买家线下交流。
- 您可以通过 notifyPayment 或 inquiryPayment 获取支付结果，并及时处理支付结果页面的跳转和显示，避免重复支付。
默认关单时间
- 该支付方式支持传入二维码的有效期，时间范围为 60 秒至 9,000 秒。交易过期时间与二维码过期时间一致。
- 当二维码展示时，您可以使用在 pay (单笔支付) 接口响应中返回的 expireTime 参数值来显示支付超时时间。
- 未到关单时间，此时商户侧关闭订单时，买家仍能够完成支付，有可能会导致潜在的单边账情况。
响应示例
以下是支付响应中的示例代码：
{
"normalUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=PqpmsKam%2BLbQyGH1KWYtA82v2t15tYwnk2OE0q4D8OE%3D&clientId=5Y607N2YJU8006726",
"orderCodeForm": {
"codeDetails": [
{
"codeValue": "https://iexpfront-sea.alipay.com/showQrImage.htm?code=lcjR2aefqftIKgIm30du1Ld7GM3W2xEb%252BW8RDmp7cNeNnRE2vIaa5pshMn2Pq4DBP3C8gm8VLPWRVLRQWjGuxUQput0bZdx%252ByXkEZoNCWBZaTG73kgHuPRzt%252FPY9iqMb9YmL6mYLUGvElNj4zblXizT77%252BvjP%252FZ8EMRBRQGTINfOUKwJp%252FtDeNFGhzRMavMrBnUSbqp25DHtaiMppf79zSYT2NtpyjykgiRhuTYy4ul%252BRKoeyWYHI27eey%252FvYlV%252BEeSjV97NW%252BR84tcnIETHYRRXBd4TsRZZSLvX52AGN4hxO5KdqrSBtwSPTFvcjEG5%252BVE4gft67ml2uT5Yi0HhAA%253D%253D&size=M&sid=188",
"displayType": "MIDDLEIMAGE"
}
],
"expireTime": "2024-03-14T19:53:24-07:00"
},
"paymentActionForm": "{"paymentActionFormType":"PaymentCodeForm","paymentCodeExpireTime":1710471204000,"paymentCodeInfos":[{"paymentCodeDetails":[{"codeValue":"00020101021226670016COM.NOBUBANK.WWW01189360050300000862130214020900006839930303UBE51440014ID.CO.QRIS.WWW0215ID20221517570460303UBE52045499530336054035005802ID59042C2P6013Jakarta Barat610511410624601140315041299373206091113322490703A010804POSP6304A241","codeValueType":"QRCODE","displayType":"IMAGE"}],"paymentCodeInfoType":"PAYMENT_CODE"}]}",
"paymentAmount": {
"currency": "PHP",
"value": "500"
},
"paymentCreateTime": "2024-03-14T19:48:21-07:00",
"paymentId": "202403151940108001001884*****8487",
"paymentRequestId": "PAY_20240*****1165",
"redirectActionForm": {
"method": "GET",
"redirectUrl": "https://iexpfront-sea-global.alipay.com/payments/method/checkout/code.html?merchantId=188iwOYLsWM%2B3OM5i43oAN6sL7yTti1YlTOEpSbxNsmiew%3D&paymentRequestId=PqpmsKam%2BLbQyGH1KWYtA82v2t15tYwnk2OE0q4D8OE%3D&clientId=5Y607N2YJU8006726"
},
"result": {
"resultCode": "PAYMENT_IN_PROCESS",
"resultMessage": "payment in process",
"resultStatus": "U"
}
}