概览
令牌化 FOP 可支持参考编号用例。想要购买商品的用户会通过付款集成商生成参考号。然后,用户会将该参考号带到便利店、自助服务终端或银行,并支付该参考号。
现金 FOP 还支持参考编号用例。代币化 FOP 和现金 FOP 的主要区别在于,代币化 FOP 需要关联并且支持退款,现金 FOP 不要求关联且不支持退款。本文档将介绍在参考编号用例中集成的工作方式。
概括来讲,集成涉及以下流程:
购买流程与现金付款方式购买流程相同。
使用网页重定向身份验证的集成示例。
相关 API
身份验证流程
集成商实现的 API:网络身份验证。
关联流程
API 由集成商实现:Payment Integrator Hosted Tokenized FOP API 上的 associateAccount。
购买流程
API 由集成商实现:Payment Integrator Hosted Tokenized FOP API 上的 generateReferenceNumber 和 cancelReferenceNumber。
由 Google 实现的 API:Google Hosted Tokenized FOP API 上的 referenceNumberPaidNotification。
退款流程
API 由集成商实现:付款集成商 Hosted Tokenized FOP API 上的 refund。
汇款流程
API 由集成商实现:请参阅 Payment Integrator Hosted Remittance API。
由 Google 实现的 API:请参阅 Google Hosted Remittance API。
所有流如何协同工作
创建乐器
在 Google 界面上,用户被重定向到集成商托管的网页以进行网络身份验证。成功通过身份验证后,系统会将用户重定向回 Google。然后,Google 会调用 associateAccount。authenticationResponse
中的 requestId
将是 associateAccount 请求的 authenticationRequestId
。成功关联后,Google 会将 googlePaymentToken
(GPT) 和其他元数据存储为用户所用的工具。
创建付款工具 - 身份验证流程
创建付款方式 - 关联流程
生成参考号
当用户想要使用该付款方式购买商品/服务时,Google 会使用 GPT 调用 generateReferenceNumber。generateReferenceNumber 请求标头中的 requestId
将用于标识相关 API 的事务。
支付参考号
用户离线支付参考编号后,集成商将调用 referenceNumberPaidNotification。generateReferenceNumber 请求标头中的 requestId
将是 referenceNumberPaidNotification 请求的 generateReferenceNumberRequestId
。
取消交易
如果用户在付款之前决定取消交易,Google 将调用 cancelReferenceNumber。generateReferenceNumber 请求标头中的 requestId
将是 cancelReferenceNumber 请求的 generateReferenceNumberRequestId
。
退还交易款项
用户支付参考编号后,如果用户想要退款,Google 会致电 refund。generateReferenceNumber 请求标头中的 requestId
将是 refund 请求的 transactionId
。
汇款
根据合同,Google 将在对账单准备就绪时调用 remittanceStatementNotification,以通知集成商。然后,集成商将调用 Google Hosted Remittance API 执行对帐。