跳转到主要内容
本指南将引导您使用 创建实体 功能注册个人和公司。创建实体时无需上传文件。您需要在下一步 上传文件和证明 中上传文件。

先决条件

  • Stage 访问令牌。请参阅 获取访问令牌。
  • 实体类型:INDIVIDUAL 适用于自然人,COMPANY 适用于法人实体。
  • 身份证明文件。对于个人:税务识别号(CPF、CUIT、RFC、CURP)或身份证明文件(DNI、PASSPORT、CC)。对于公司:税务识别号(CNPJ、CUIT、RFC、RUC、NIT)。它将成为主要文件。
  • 稳定的 externalId:您自己的参考编号,每个商家独一无二。
  • 如果 Localpayment 为您的商户配置了自定义字段,请参阅 自定义字段 部分。

需要申报哪些文件

一份文件对应一个 id,其中可包含您需要的任意数量的文件,例如身份证件的正面、背面和自拍照。创建实体时,请在 document 中发送身份证明文件:它将成为主要文件。其他所有文件请使用 添加文件 进行申报。type + id 的组合在您的商户中必须是唯一的。 完整的值列表请参阅 文档和证明类型。

最低数据

缺少必需的 KYC 数据将返回 422 INCOMPLETE_KYC_DATA。

创建个人

Request
Response
响应状态码为 201 Created,并带有以下标头:ETag: "0"。 请保留 internalId(实体)和 document.documentId(主要文件)。后续步骤需要用到这两个值。

创建公司

以税务识别号为主要文件、包含附加行的地址以及自定义字段的公司:

处理集成中的错误

常见错误

自定义字段验证错误示例:
税务识别号(CPF、CNPJ、CUIT、RFC)是一份文件,而不是实体的字段。请在 document 中发送。国家代码必须符合 ISO 3166-1 alpha-3 标准(使用 BRA,而不是 BR)。

下一步

上传文件和证明

请附上支持每个已声明文档的文件。

创建实体引用

所有请求字段、响应字段和错误代码。
最后修改于 2026年11月10日