令牌化

运行机制

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

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

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

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

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

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

  • 银行卡
  • Amazon Pay
  • Skrill Digital Wallet
  • PayPal
  • 支付宝
  • GCash
  • DANA
  • Rabbit LINE pay
  • Touch ’n Go
  • Boost
  • Toss

如何获取

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

使用保存的支付帐户付款

要在不打开支付UI的情况下使用保存的支付帐户进行付款,请通过以下方式在您的应用中实现支付过程:
  1. 获取用户保存的支付帐户列表
  2. 通过支付帐户之一向用户扣款
  3. 处理在支付Webhook中收到的数据,将所购虚拟商品发放给用户。
注意
所购虚拟商品只能根据支付Webhook中的数据发放。

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

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

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

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

注:
要设置添加和删除支付帐户的Webhook,请联系您的客户成功经理或发送邮件至csm@xsolla.com

处理管理保存的支付帐户页面上的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的事件。

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

    不想回答

    感谢您的反馈!
    上次更新时间: 2023年10月10日

    发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

    报告问题
    我们非常重视内容质量。您的反馈将帮助我们做得更好。
    请留下邮箱以便我们后续跟进
    感谢您的反馈!