跳转到主要内容
使用 Localpayment 的令牌化技术可以安全地处理卡片信息,降低安全风险,简化未来的交易。

工作原理

该过程包括以下关键步骤:
  1. 卡片信息收集:卡片信息通过您应用程序中的表单安全收集,然后传输到 Localpayment API。
  2. 令牌生成:Localpayment 安全地存储卡片信息,并生成一个代表卡片详细信息的唯一且不可逆的令牌。此令牌将随 API 响应一起返回。
  3. 使用已令牌化的卡片:在后续的卡片支付中,您将发送 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 认证增强令牌化卡支付的安全性。
最后修改于 2026年11月10日