跳转到主要内容
GET
获取自定义字段架构
返回您的商家已发布的自定义字段模式,格式为 JSON Schema(默认)或 Localpayment 原生字段定义(?format=definition)。在调用 API 之前,可用它来构建表单并验证 attributes。
  • 模式由 Localpayment 在入驻期间为您的商家定义并发布;如需更改,请通过您的客户经理申请。
  • 未发布模式时,attributes 将不经验证直接被接受,且此接口返回 404。
  • 该模式同时适用于 INDIVIDUAL 和 COMPANY 实体。
错误使用带有固定 code 的 application/problem+json。完整目录:实体状态和错误代码。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。系统将据此识别您的商户账户和执行操作的用户。

示例:

"Bearer <your_access_token>"

X-Correlation-ID
string

跟踪标识符(UUID)。会在响应中原样返回;如未提供,则由 Localpayment 生成。

示例:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

查询参数

format
enum<string>

用于接收原生字段列表的定义。默认值:JSON Schema 2020-12。

可用选项:
definition

响应

OK。

$schema
string
示例:

"https://json-schema.org/draft/2020-12/schema"

type
string
示例:

"object"

properties
object
additionalProperties
boolean
示例:

false

最后修改于 2026年11月10日