Tokenization API 2.0

Tokenization幫助您收集客户授权并通过 Codapay 提供的支付渠道进行一键点击 (one-click) 或订阅来启用后续付款的一种方式。因此，Codapay 将提供所有必要的方法，以便您能够保存用户的付款方式，并在需要时方便地向用户收费。

Tokenization 如何运作？

对于每个支持Tokenization的支付渠道，Codapay 提供了四个核心功能：

1. 保存用户付款信息

2. 向用户收费

3. 查询收费状态

4. 一键点击 (one-click) 或发起定期收费（订阅）

此文档包含哪些新消息？

版本	更新日期	备注
2.0	28.07.2023	API 初始文档
2.1	28.11.2023	添加 Mada Webhook 请求头 新增扣款用户操作
2.2	28.02.2024	添加 DANA Wallet 修改了电子邮件验证流程 新增账户解绑流程

定义和概念

Shopper

Shopper ID 是分配给客户的唯一标识符。您可以通过调用 shopper 端点来生成一个 shopper。Shopper 可以通过以下信息进行识别：

• Shopper ID（由 Coda 生成）

• Partner Shopper ID（对应于您自己的客户标识符）

• 电子邮件地址

• 电话号码

• 状态码（激活/未激活）

Payment Method

支付方式ID是链接购物者和付款方式的独特识别码。您可以在此处参考可用付款方式的列表。支付方式可以通过以下信息来识别：

• 付款方式 ID（Coda 将生成）

• 购物者 ID（您最初使用 Coda 生成的）

• 类型（对应支付方式名称，例如Go-Pay、card）

• 具体支付方式详情（参见支付方式详情章节）

Token

Token ID是链接支付方式和Token的独特识别码。Token 可以通过以下信息来识别：

• Token ID（Coda 将生成）

• 支付方式 ID（您最初使用 Coda 生成的）

• Token状态（有效或过期）

Charge

Charge ID 是用于标识收费交易的唯一标识符。Charge 可以通过以下信息进行识别：

• Charge ID（由 Coda 生成）

• Token ID（您最初与 Coda 生成的令牌）

• 产品详情（商品名称）

• 收费金额

• 状态（收费是否成功）

Subscription Plan

Subscription Plan 可通过以下信息进行识别：

• Subscription Plan ID（由 Coda 生成）

• 周期性收费金额

• 重复周期（每 X 周/月/季度/年）

Subscription

Subscription 可通过以下信息进行识别：

• Subscription Plan ID（订阅计划标识符）

• Token ID（您最初与 Coda 生成的令牌）