参考编号用例

概览

令牌化 FOP 可支持参考编号用例。想要购买商品的用户会通过付款集成商生成参考号。然后,用户会将该参考号带到便利店、自助服务终端或银行,并支付该参考号。

现金 FOP 还支持参考编号用例。代币化 FOP 和现金 FOP 的主要区别在于,代币化 FOP 需要关联并且支持退款,现金 FOP 不要求关联且不支持退款。本文档将介绍在参考编号用例中集成的工作方式。

概括来讲,集成涉及以下流程:

  1. 身份验证流程
  2. 关联流程
  3. 购买流程(与现金 FOP 相同)
  4. 退款流程
  5. 汇款流程

购买流程与现金付款方式购买流程相同。

使用网页重定向身份验证的集成示例。

身份验证流程

集成商实现的 API:网络身份验证

关联流程

API 由集成商实现:Payment Integrator Hosted Tokenized FOP API 上的 associateAccount

购买流程

API 由集成商实现:Payment Integrator Hosted Tokenized FOP API 上的 generateReferenceNumbercancelReferenceNumber

由 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 会调用 associateAccountauthenticationResponse 中的 requestId 将是 associateAccount 请求的 authenticationRequestId。成功关联后,Google 会将 googlePaymentToken(GPT) 和其他元数据存储为用户所用的工具。

创建付款工具 - 身份验证流程

Web 身份验证流程

创建付款方式 - 关联流程

关联流程图

生成参考号

当用户想要使用该付款方式购买商品/服务时,Google 会使用 GPT 调用 generateReferenceNumbergenerateReferenceNumber 请求标头中的 requestId 将用于标识相关 API 的事务。

现金生成参考编号

支付参考号

用户离线支付参考编号后,集成商将调用 referenceNumberPaidNotificationgenerateReferenceNumber 请求标头中的 requestId 将是 referenceNumberPaidNotification 请求的 generateReferenceNumberRequestId

付款参考编号流程

取消交易

如果用户在付款之前决定取消交易,Google 将调用 cancelReferenceNumbergenerateReferenceNumber 请求标头中的 requestId 将是 cancelReferenceNumber 请求的 generateReferenceNumberRequestId

退还交易款项

用户支付参考编号后,如果用户想要退款,Google 会致电 refundgenerateReferenceNumber 请求标头中的 requestId 将是 refund 请求的 transactionId

退款流程

汇款

根据合同,Google 将在对账单准备就绪时调用 remittanceStatementNotification,以通知集成商。然后,集成商将调用 Google Hosted Remittance API 执行对帐。