工作原理
该过程包括以下关键步骤:- 卡片信息收集:卡片信息通过您应用程序中的表单安全收集,然后传输到 Localpayment API。
- 令牌生成:Localpayment 安全地存储卡片信息,并生成一个代表卡片详细信息的唯一且不可逆的令牌。此令牌将随 API 响应一起返回。
- 使用已令牌化的卡片:在后续的卡片支付中,您将发送
card.token属性,而不是客户的实际卡片信息。
开始之前
在对卡片进行标记化之前,请确保已完成以下步骤:API凭证
用于身份验证的有效 API 凭据和访问令牌。
账户设置
为您的目标国家/地区正确设置账户并进行业务验证。
IP白名单
将服务器 IP 地址加入 API 访问白名单。
Webhook endpoint
设置 webhook URL 以接收付款通知。
令牌化方法
卡片标记化有两种可用方法:选项 1:卡片令牌化 endpoint
您可以通过专用 endpoint 安全地对卡片信息进行令牌化处理,以便将来使用。 要对卡片进行令牌化,请向卡片令牌化endpoint 发送POST 请求,并包含以下参数:
示例请求
curl
成功响应示例
作为响应,API 返回卡令牌:关键响应字段
选项 2:支付过程中的卡片令牌化
Localpayment 允许商户在支付处理期间,通过在支付请求中包含save 参数来对卡片进行令牌化。这种简化的方式让您只需一次 API 调用,即可同时处理交易并存储卡片详细信息。
要对卡片进行令牌化,请向创建 Payin endpoint 发送 POST 请求,并在您的 Payin 请求中将 card.save 属性设置为 true。
示例请求
curl
成功响应示例
作为响应,API 返回卡令牌:关键响应字段
使用代币化卡片
要使用已令牌化的卡片进行支付,请在您的支付请求中包含card.token。
带令牌的示例请求
curl
获取卡片信息
卡片完成令牌化后,您可以使用 Localpayment API 获取其详细信息。这样,您就可以在满足 PCI 合规性要求的同时,向客户展示已存储的支付方式。 要获取卡片信息,请向获取卡片详情endpoint 发送GET 请求,并将该卡片的令牌作为查询参数传入。
示例请求
curl
成功响应示例
API 会返回卡片详细信息:删除已标记的卡片
通过专用 API 接口永久删除已存储的卡片令牌。此不可逆操作有助于遵守数据隐私法规,并实现妥善的卡片生命周期管理。 要删除已令牌化的卡片,请向删除令牌化卡endpoint 发送DELETE 请求,并将该卡片的令牌作为查询参数传入。
示例请求
curl
成功响应示例
成功删除操作通常会返回一个空的 JSON 对象:后续步骤
现在您已成功对卡片进行令牌化,可以使用生成的令牌在 Localpayment 的支付服务中进行安全处理:一次性付款
使用该令牌处理单笔即时付款。
订阅
使用令牌卡设置自动定期付款周期。
分期付款
使用代币化卡为您的客户提供分期付款选项。
3D 安全
使用 3D Secure 认证增强令牌化卡支付的安全性。

