> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新实体

部分更新 KYC 数据、地址和自定义字段。仅更改所发送的字段。需要在 If-Match 中提供当前版本，以避免覆盖并发更改。

* 缺少 If-Match 时返回 400；值已过期时返回 412 VERSION\_CONFLICT。请重新读取实体，并使用新的 ETag 重试。
* type、externalId、birthdate、nationality、birthCountry、incorporationDate 和 incorporationCountry 不能通过此 endpoint 更改。
* 文件通过 Documents endpoint 管理，而不是在此处。
* 编辑实体数据不会重置证明审核。
* 实体处于 IN\_REVIEW 状态时被锁定（409 ENTITY\_IN\_REVIEW）；处于 REJECTED、BLOCKED 和 CLOSED 状态的实体不能编辑（409 ENTITY\_NOT\_EDITABLE）。

错误使用带有稳定 `code` 的 `application/problem+json`。完整目录：[实体状态与错误码](https://docs.localpayment.com/zh/reference/entity-statuses-and-error-codes.md)。


## OpenAPI

````yaml openapi/zh/localpayment.json PATCH /api/entity/v1/entities/{entityId}
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/entity/v1/entities/{entityId}:
    patch:
      summary: 更新实体
      operationId: update-entity
      parameters:
        - name: Authorization
          in: header
          description: >-
            用于身份验证的 Bearer
            访问令牌。该令牌可从[获取访问令牌](/zh/reference/get-token)或[刷新访问令牌](/zh/reference/refresh-token)endpoint
            获取。系统将据此识别您的商户账户和执行操作的用户。
          required: true
          schema:
            type: string
            examples:
              - Bearer <your_access_token>
        - name: If-Match
          in: header
          description: 实体版本以上次读取操作的 ETag 标头返回的版本为准。防止并发更新。
          required: true
          schema:
            type: string
            examples:
              - '"0"'
        - name: X-Correlation-ID
          in: header
          description: 跟踪标识符（UUID）。会在响应中原样返回；如未提供，则由 Localpayment 生成。
          required: false
          schema:
            type: string
            examples:
              - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
        - name: entityId
          in: path
          description: 实体的 internalId。
          required: true
          schema:
            type: string
            examples:
              - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: 名字/法定姓名。
                  examples:
                    - Jane
                lastname:
                  type: string
                  description: 姓。
                  examples:
                    - Doe
                occupation:
                  type: string
                  description: 职业。
                  examples:
                    - Engineer
                residenceCountry:
                  type: string
                  description: ISO 3166-1 alpha-3。
                  examples:
                    - BRA
                website:
                  type: string
                  description: 网站。
                  examples:
                    - https://www.example.com/new
                legalRepresentativeName:
                  type: string
                  description: 法定代表人。
                  examples:
                    - Jane Doe
                email:
                  type: string
                  description: 联系邮箱。
                  examples:
                    - jane.doe@example.com
                phone:
                  type: object
                  description: '{ countryCode, areaCode, number }，仅限数字。'
                address:
                  type: object
                  description: 完整地址对象（替换已存储的地址）。
                attributes:
                  type: object
                  description: 自定义字段；已根据已发布的架构进行验证。
                isPep:
                  type: boolean
                  description: 政治公众人物。
                  examples:
                    - false
            examples:
              Example 1:
                value:
                  website: https://www.example.com/new
                  phone:
                    countryCode: '55'
                    areaCode: '11'
                    number: '999990099'
      responses:
        '200':
          description: OK。
          content:
            application/json:
              schema:
                type: object
                properties:
                  internalId:
                    type: string
                    examples:
                      - 7c9e6679-7425-40de-944b-e07fc1f90ae7
                    format: uuid
                    description: Localpayment 的实体标识符。请在其他所有 Entities endpoint 中使用它。
                  externalId:
                    type: string
                    examples:
                      - f47ac10b-58cc-4372-a567-0e02b2c3d479
                    description: 您发送的标识符。
                  type:
                    type: string
                    examples:
                      - COMPANY
                    enum:
                      - INDIVIDUAL
                      - COMPANY
                    description: INDIVIDUAL 或 COMPANY。
                  status:
                    type: string
                    examples:
                      - PENDING_KYC
                    enum:
                      - PENDING_KYC
                      - IN_REVIEW
                      - ACTIVE
                      - REJECTED
                      - BLOCKED
                      - CLOSED
                    description: 实体状态。请参阅实体状态和错误代码。
                  name:
                    type: string
                    examples:
                      - Example Company S.A.
                  lastname:
                    type:
                      - string
                      - 'null'
                  birthdate:
                    type:
                      - string
                      - 'null'
                    format: date
                  gender:
                    type:
                      - string
                      - 'null'
                  nationality:
                    type:
                      - string
                      - 'null'
                  birthCountry:
                    type:
                      - string
                      - 'null'
                  residenceCountry:
                    type:
                      - string
                      - 'null'
                  occupation:
                    type:
                      - string
                      - 'null'
                  isPep:
                    type: boolean
                    examples:
                      - false
                  incorporationDate:
                    type: string
                    examples:
                      - '2020-01-15'
                    format: date
                  incorporationCountry:
                    type: string
                    examples:
                      - BRA
                  website:
                    type: string
                    examples:
                      - https://www.example.com/new
                  legalRepresentativeName:
                    type: string
                    examples:
                      - Jane Doe
                  email:
                    type: string
                    examples:
                      - test@example.com
                  phone:
                    type: object
                    properties:
                      countryCode:
                        type: string
                        examples:
                          - '55'
                      areaCode:
                        type: string
                        examples:
                          - '11'
                      number:
                        type: string
                        examples:
                          - '999990099'
                  address:
                    type: object
                    properties:
                      street:
                        type: string
                        examples:
                          - Rua Exemplo
                      city:
                        type: string
                        examples:
                          - São Paulo
                      state:
                        type: string
                        examples:
                          - SP
                      zipCode:
                        type: string
                        examples:
                          - 01310-100
                      number:
                        type: string
                        examples:
                          - '100'
                      comment:
                        type:
                          - string
                          - 'null'
                      country:
                        type: string
                        examples:
                          - BRA
                      line2:
                        type: string
                        examples:
                          - Sala 100
                      line3:
                        type: string
                        examples:
                          - Torre A
                  attributes:
                    type: object
                    properties:
                      emailPixKey:
                        type: string
                        examples:
                          - test@example.com
                      socialMedia:
                        type: string
                        examples:
                          - https://www.linkedin.com/company/example
                      numberOfEmployees:
                        type: string
                        examples:
                          - 11-50
                      countryTaxResidence:
                        type: string
                        examples:
                          - BRA
                      sourceOfFundsAndIncome:
                        type: string
                        examples:
                          - sales_of_goods_and_services
                      reasonForAccountOpening:
                        type: string
                        examples:
                          - receive_payments_for_goods_and_services
                      estimatedAnnualRevenueUsd:
                        type: string
                        examples:
                          - 1m_to_10m
                      estimatedMonthlyVolumeUsd:
                        type: string
                        examples:
                          - '50000'
                      businessActivityDescription:
                        type: string
                        examples:
                          - >-
                            Online retail of home goods. Receives payments from
                            end customers in Brazil via PIX.
                  documentationStatus:
                    type: string
                    examples:
                      - NO_FILES
                    enum:
                      - NO_FILES
                      - PARTIAL
                      - COMPLETE
                    description: >-
                      NO_FILES、PARTIAL 或
                      COMPLETE：表示已申报的文件中是没有、部分还是全部至少包含一个文件。它衡量的是文件是否存在，而非是否获批。
                  document:
                    type: object
                    properties:
                      documentId:
                        type: string
                        examples:
                          - 91eaf0c8-844b-42a1-a614-304edbcfa57d
                        format: uuid
                      entityId:
                        type: string
                        examples:
                          - 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        format: uuid
                      type:
                        type: string
                        examples:
                          - CNPJ
                        enum:
                          - DNI
                          - NATIONAL_ID
                          - DRIVER_LICENSE
                          - PASSPORT
                          - CE
                          - CC
                          - CUIT
                          - CUIL
                          - RFC
                          - CURP
                          - CPF
                          - CNPJ
                          - RUC
                          - NIT
                          - TAX_ID
                          - ARTICLES_OF_INCORPORATION
                          - POWER_OF_ATTORNEY
                          - TAX_CERTIFICATE
                          - PAYSLIP
                          - ARCA_REGISTRATION
                          - PROOF_OF_ADDRESS
                          - PROOF_OF_FUNDS
                          - OTHER
                        description: INDIVIDUAL 或 COMPANY。
                      id:
                        type: string
                        examples:
                          - '00000000000100'
                      issuingCountry:
                        type: string
                        examples:
                          - BRA
                      issueDate:
                        type:
                          - string
                          - 'null'
                        format: date
                      expirationDate:
                        type:
                          - string
                          - 'null'
                        format: date
                      isPrimary:
                        type: boolean
                        examples:
                          - true
                      status:
                        type: string
                        examples:
                          - PENDING
                        enum:
                          - PENDING
                          - VERIFIED
                          - REJECTED
                          - EXPIRED
                        description: >-
                          派生的文档状态：如果 expirationDate 已过，则为
                          EXPIRED；如果任何有效证明文件被拒绝，则为 REJECTED；如果所有有效证明文件均已批准，则为
                          VERIFIED；否则为 PENDING。
                      metadata:
                        type:
                          - object
                          - 'null'
                      proofs:
                        type: array
                        items:
                          type: object
                      createdAt:
                        type: string
                        examples:
                          - '2024-01-15T17:18:53Z'
                        format: date-time
                        description: ISO 8601 UTC 时间戳。
                      updatedAt:
                        type: string
                        examples:
                          - '2024-01-15T17:19:23Z'
                        format: date-time
                        description: ISO 8601 UTC 时间戳。
                    description: 主要文档，包含其 documentId（上传文件时需要）、派生的状态以及当前的 proofs[]。
                  documents:
                    type: array
                    items:
                      type: object
                      properties:
                        documentId:
                          type: string
                          examples:
                            - a4f9d2ed-c365-4a0b-b775-9278c039af93
                          format: uuid
                        entityId:
                          type: string
                          examples:
                            - 7c9e6679-7425-40de-944b-e07fc1f90ae7
                          format: uuid
                        type:
                          type: string
                          examples:
                            - ARTICLES_OF_INCORPORATION
                          enum:
                            - DNI
                            - NATIONAL_ID
                            - DRIVER_LICENSE
                            - PASSPORT
                            - CE
                            - CC
                            - CUIT
                            - CUIL
                            - RFC
                            - CURP
                            - CPF
                            - CNPJ
                            - RUC
                            - NIT
                            - TAX_ID
                            - ARTICLES_OF_INCORPORATION
                            - POWER_OF_ATTORNEY
                            - TAX_CERTIFICATE
                            - PAYSLIP
                            - ARCA_REGISTRATION
                            - PROOF_OF_ADDRESS
                            - PROOF_OF_FUNDS
                            - OTHER
                          description: INDIVIDUAL 或 COMPANY。
                        id:
                          type: string
                          examples:
                            - ART-00000000000100
                        issuingCountry:
                          type: string
                          examples:
                            - BRA
                        issueDate:
                          type:
                            - string
                            - 'null'
                          format: date
                        expirationDate:
                          type:
                            - string
                            - 'null'
                          format: date
                        isPrimary:
                          type: boolean
                          examples:
                            - false
                        status:
                          type: string
                          examples:
                            - PENDING
                          enum:
                            - PENDING
                            - VERIFIED
                            - REJECTED
                            - EXPIRED
                          description: >-
                            派生的文档状态：如果 expirationDate 已过，则为
                            EXPIRED；如果任何有效证明文件被拒绝，则为 REJECTED；如果所有有效证明文件均已批准，则为
                            VERIFIED；否则为 PENDING。
                        metadata:
                          type:
                            - object
                            - 'null'
                        proofs:
                          type: array
                          items:
                            type: object
                        createdAt:
                          type: string
                          examples:
                            - '2024-01-15T17:18:53Z'
                          format: date-time
                          description: ISO 8601 UTC 时间戳。
                        updatedAt:
                          type: string
                          examples:
                            - '2024-01-15T17:19:23Z'
                          format: date-time
                          description: ISO 8601 UTC 时间戳。
                    description: 其他已声明的文档（主要文档仅出现在 document 中），结构相同。
                  version:
                    type: integer
                    examples:
                      - 1
                    description: 实体版本。等于 ETag 标头；在 PATCH 请求中将其作为 If-Match 发送回。
                  createdAt:
                    type: string
                    examples:
                      - '2024-01-15T17:18:53Z'
                    format: date-time
                    description: ISO 8601 UTC 时间戳。
                  updatedAt:
                    type: string
                    examples:
                      - '2024-01-15T17:19:23Z'
                    format: date-time
                    description: ISO 8601 UTC 时间戳。
                  customFieldSchemaVersion:
                    type: integer
                    examples:
                      - 9
                    description: 用于验证属性的自定义字段架构版本，或 null。
              examples:
                Example 1:
                  value:
                    internalId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                    externalId: f47ac10b-58cc-4372-a567-0e02b2c3d479
                    type: COMPANY
                    status: PENDING_KYC
                    name: Example Company S.A.
                    lastname: null
                    birthdate: null
                    gender: null
                    nationality: null
                    birthCountry: null
                    residenceCountry: null
                    occupation: null
                    isPep: false
                    incorporationDate: '2020-01-15'
                    incorporationCountry: BRA
                    website: https://www.example.com/new
                    legalRepresentativeName: Jane Doe
                    email: test@example.com
                    phone:
                      countryCode: '55'
                      areaCode: '11'
                      number: '999990099'
                    address:
                      street: Rua Exemplo
                      city: São Paulo
                      state: SP
                      zipCode: 01310-100
                      number: '100'
                      comment: null
                      country: BRA
                      line2: Sala 100
                      line3: Torre A
                    attributes:
                      emailPixKey: test@example.com
                      socialMedia: https://www.linkedin.com/company/example
                      numberOfEmployees: 11-50
                      countryTaxResidence: BRA
                      sourceOfFundsAndIncome: sales_of_goods_and_services
                      reasonForAccountOpening: receive_payments_for_goods_and_services
                      estimatedAnnualRevenueUsd: 1m_to_10m
                      estimatedMonthlyVolumeUsd: '50000'
                      businessActivityDescription: >-
                        Online retail of home goods. Receives payments from end
                        customers in Brazil via PIX.
                    documentationStatus: NO_FILES
                    document:
                      documentId: 91eaf0c8-844b-42a1-a614-304edbcfa57d
                      entityId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                      type: CNPJ
                      id: '00000000000100'
                      issuingCountry: BRA
                      issueDate: null
                      expirationDate: null
                      isPrimary: true
                      status: PENDING
                      metadata: null
                      proofs: []
                      createdAt: '2024-01-15T17:18:53Z'
                      updatedAt: '2024-01-15T17:19:23Z'
                    documents:
                      - documentId: a4f9d2ed-c365-4a0b-b775-9278c039af93
                        entityId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        type: ARTICLES_OF_INCORPORATION
                        id: ART-00000000000100
                        issuingCountry: BRA
                        issueDate: null
                        expirationDate: null
                        isPrimary: false
                        status: PENDING
                        metadata: null
                        proofs: []
                        createdAt: '2024-01-15T17:18:53Z'
                        updatedAt: '2024-01-15T17:19:23Z'
                      - documentId: 5ca3e868-2b76-4390-b25a-5d10c0db8516
                        entityId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        type: TAX_ID
                        id: 00.000.000/0001-00
                        issuingCountry: BRA
                        issueDate: null
                        expirationDate: null
                        isPrimary: false
                        status: PENDING
                        metadata: null
                        proofs: []
                        createdAt: '2024-01-15T17:18:54Z'
                        updatedAt: '2024-01-15T17:19:23Z'
                    version: 1
                    createdAt: '2024-01-15T17:18:53Z'
                    updatedAt: '2024-01-15T17:19:23Z'
                    customFieldSchemaVersion: 9
          headers:
            ETag:
              description: 实体版本。在“更新实体”时，将其作为 If-Match 标头发送回。
              schema:
                type: string
                examples:
                  - '"0"'
        '400':
          description: >-
            错误请求。验证错误：缺少字段、标头、路径或查询参数，或者参数未知或无效。details[]
            列出了字段和问题。自定义字段无效：属性不符合您的自定义字段架构。details[] 列出了字段和问题。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - VALIDATION_ERROR:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      A field, header, path or query parameter is missing,
                      unknown or invalid. details[] lists field and issue.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: VALIDATION_ERROR
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: externalId
                        issue: REQUIRED
                Example 2 - CUSTOM_FIELDS_INVALID:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      attributes does not satisfy your custom-fields schema.
                      details[] lists field and issue.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: CUSTOM_FIELDS_INVALID
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: numberOfEmployees
                        issue: NOT_IN_OPTIONS
        '401':
          description: 未授权。UNAUTHORIZED：缺少或无效的访问令牌。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNAUTHORIZED:
                  value:
                    type: about:blank
                    title: Unauthorized
                    status: 401
                    detail: Missing or invalid access token.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '404':
          description: 未找到。ENTITY_NOT_FOUND：该实体不存在或属于其他商家。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - ENTITY_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: The entity does not exist or belongs to another merchant.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: ENTITY_NOT_FOUND
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '409':
          description: >-
            冲突。ENTITY_NOT_EDITABLE：该实体处于 REJECTED、BLOCKED 或 CLOSED
            状态，或者该操作将删除主文档或唯一文档。ENTITY_IN_REVIEW：该实体处于 IN_REVIEW 状态：在
            Localpayment 合规团队处理完毕之前，其数据、文档、文件和 UBO 关联将被冻结。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - ENTITY_NOT_EDITABLE:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: >-
                      The entity is REJECTED, BLOCKED or CLOSED, or the
                      operation would remove the primary document or the only
                      document.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: ENTITY_NOT_EDITABLE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
                Example 2 - ENTITY_IN_REVIEW:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: >-
                      The entity is IN_REVIEW: its data, documents, files and
                      UBO links are frozen until Localpayment Compliance
                      resolves it.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: ENTITY_IN_REVIEW
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '412':
          description: 前提条件失败。VERSION_CONFLICT：If-Match 与当前实体版本不匹配。请重新读取实体并重试。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - VERSION_CONFLICT:
                  value:
                    type: about:blank
                    title: Precondition failed
                    status: 412
                    detail: Precondition failed
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: VERSION_CONFLICT
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '413':
          description: 有效载荷过大。PAYLOAD_TOO_LARGE：属性超过 64 KB。
          content:
            application/problem+json:
              schema:
                type: object
                description: RFC 9457 问题详情（application/problem+json）。
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: 问题简述。
                  status:
                    type: integer
                    description: HTTP状态码。
                  detail:
                    type: string
                    description: 易于理解的解释。
                  instance:
                    type: string
                    description: 请求路径。
                  code:
                    type: string
                    description: 稳定的机器可读错误代码。根据此值进行分支。
                  correlationId:
                    type: string
                    format: uuid
                    description: 请求标识符。联系客服时请提供此标识符。
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: 出错字段（如适用）。
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - PAYLOAD_TOO_LARGE:
                  value:
                    type: about:blank
                    title: Payload too large
                    status: 413
                    detail: attributes exceeds 64 KB.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    code: PAYLOAD_TOO_LARGE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.