令牌化

运行机制

令牌化指一组允许在不打开支付UI或无需用户操作的情况下安全处理付款的API端点。主要功能:

  • 获取保存的支付帐户列表
  • 使用保存的支付帐户进行付款
  • 删除支付帐户

在以下情况下会保存支付帐户:

  • 通过支付中心UI进行付款。如果用户在输入支付数据时同意保存数据,则会新增一个保存的帐户。
  • 支付中心在保存支付帐户模式下打开。要启用该模式,请在获取令牌时传入settings.ui.mode参数。

保存支付帐户后会给该帐户一个ID。在API请求中指定该ID可在无需用户操作及不打开支付UI的情况下进行付款。

支持令牌化的支付方式包括:

  • 银行卡
  • Skrill Digital Wallet
  • Yandex.Money
  • WebMoney
  • PayPal
  • QIWI Wallet

Note
要为QIWI Wallet设置令牌化,请联系您的帐户经理。

如何获取

要使用令牌化,请实现与保存的支付帐户进行交互的端点

使用保存的支付帐户付款

要在不打开支付UI的情况下使用保存的支付帐户进行付款,请通过以下方式在您的应用中实现支付过程:

  1. 获取用户保存的支付帐户列表
  2. 通过支付帐户之一向用户扣款
  3. 处理在支付Webhook中收到的数据,将所购虚拟商品发放给用户。

Notice
所购虚拟商品只能根据支付Webhook中的数据发放。

在己侧显示保存的支付帐户

通过获取保存的帐户请求,可在您的订单页面上获取脱敏的用户保存支付帐户数据。

要在己侧存储用户保存支付帐户的脱敏数据并保持更新:

  1. 设置添加支付帐户Webhook。当用户添加了新的支付帐户时,您可以保存该帐户并在之后建议用户通过该帐户进行付款而不必打开支付UI。
  2. 设置删除支付帐户Webhook。

Note
要设置添加和删除支付帐户的Webhook,请联系您的帐户经理。

处理管理保存的支付帐户页面上的UI事件

要在管理保存的支付帐户页面上实时显示信息,请处理以下支付UI事件:

  • add_saved_account — 用于更新合作伙伴侧管理用户帐户页面上的数据。包含添加的支付帐户的信息。

格式:

Copy
Full screen
Small screen
    command: "add_saved_account"
    data:
    id: 12345678
    name: "1111111111111111"
    payment_method: 0001
    type: "card"

    • add_saved_account_error — 用于跟踪保存新支付帐户时发生的错误。
    • cancel_save_account — 用户拒绝保存新用户帐户时使用。

    如果支付UI在iframe中打开或使用Pay Station Embed脚本,您将通过postMessage获得支付UI的事件。

    本文对您的有帮助吗?
    谢谢!
    我们还有其他可改进之处吗? 留言
    非常抱歉
    请说明为何本文没有帮助到您。 留言
    感谢您的反馈!
    我们会查看您的留言并运用它改进用户体验。