令牌化

运行机制

令牌化指一组允许在不打开支付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
• PayPay
• Paysafecard
• TrueMoney Wallet
• Klarna

如何获取

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

使用保存的支付帐户付款

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

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

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

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

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

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

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

• add_saved_account — 保存支付帐户成功。

格式：

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的事件。