Pular para o conteúdo principal
PATCH
Atualizar uma entidade
Atualiza parcialmente os dados de KYC, o endereço e os campos personalizados. Apenas os campos enviados são alterados. Exige a versão atual em If-Match para evitar a sobrescrita de alterações concorrentes.
  • A ausência de If-Match retorna 400; um valor desatualizado retorna 412 VERSION_CONFLICT. Leia a entidade novamente e tente de novo com o novo ETag.
  • type, externalId, birthdate, nationality, birthCountry, incorporationDate e incorporationCountry não podem ser alterados por este endpoint.
  • Os documentos são gerenciados com os endpoints de Documents, não aqui.
  • Editar os dados da entidade não reinicia as revisões das provas.
  • Enquanto a entidade estiver IN_REVIEW, ela fica bloqueada (409 ENTITY_IN_REVIEW); entidades REJECTED, BLOCKED e CLOSED não podem ser editadas (409 ENTITY_NOT_EDITABLE).
Os erros usam application/problem+json com um code estável. Catálogo completo: Entity Statuses and Error Codes.

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso. Sua conta de comerciante e o usuário que realiza a ação são identificados a partir dele.

Exemplo:

"Bearer <your_access_token>"

If-Match
string
obrigatório

Versão da entidade conforme retornada no cabeçalho ETag da sua última leitura. Protege contra atualizações simultâneas.

Exemplo:

"\"0\""

X-Correlation-ID
string

Identificador de rastreamento (UUID). Exibido na resposta; gerado pelo Localpayment se ausente.

Exemplo:

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

Parâmetros de caminho

entityId
string<uuid>
obrigatório

ID interno da entidade.

Exemplo:

"5aced5da-40c1-4bec-85ff-c8cd1bcb4526"

Corpo

application/json
name
string

Primeiro nome / nome legal.

Exemplo:

"Jane"

lastname
string

Sobrenome.

Exemplo:

"Doe"

occupation
string

Ocupação.

Exemplo:

"Engineer"

residenceCountry
string

ISO 3166-1 alfa-3.

Exemplo:

"BRA"

website
string

Site.

Exemplo:

"https://www.example.com/new"

Representante legal.

Exemplo:

"Jane Doe"

email
string

E-mail para contato.

Exemplo:

"jane.doe@example.com"

phone
object

{ countryCode, areaCode, number }, apenas dígitos.

address
object

Objeto de endereço completo (substitui o endereço armazenado).

attributes
object

Campos personalizados; validados em relação ao esquema publicado.

isPep
boolean

Pessoa politicamente exposta.

Exemplo:

false

Resposta

OK.

internalId
string<uuid>

Identificador da entidade na Localpayment. Use-o em todos os outros endpoints de Entities.

Exemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

externalId
string

Seu identificador, conforme enviado.

Exemplo:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

type
enum<string>

PESSOA FÍSICA ou EMPRESA.

Opções disponíveis:
INDIVIDUAL,
COMPANY
Exemplo:

"COMPANY"

status
enum<string>

Status da entidade. Consulte Status da entidade e Códigos de erro.

Opções disponíveis:
PENDING_KYC,
IN_REVIEW,
ACTIVE,
REJECTED,
BLOCKED,
CLOSED
Exemplo:

"PENDING_KYC"

name
string
Exemplo:

"Example Company S.A."

lastname
string | null
birthdate
string<date> | null
gender
string | null
nationality
string | null
birthCountry
string | null
residenceCountry
string | null
occupation
string | null
isPep
boolean
Exemplo:

false

incorporationDate
string<date>
Exemplo:

"2020-01-15"

incorporationCountry
string
Exemplo:

"BRA"

website
string
Exemplo:

"https://www.example.com/new"

Exemplo:

"Jane Doe"

email
string
Exemplo:

"test@example.com"

phone
object
address
object
attributes
object
documentationStatus
enum<string>

NO_FILES, PARTIAL ou COMPLETE: indica se nenhum, alguns ou todos os documentos declarados possuem pelo menos um arquivo. Mede a presença de arquivos, não a aprovação.

Opções disponíveis:
NO_FILES,
PARTIAL,
COMPLETE
Exemplo:

"NO_FILES"

document
object

O documento principal com seu documentId (necessário para enviar arquivos), o status derivado e as proofs[] atuais.

documents
object[]

Os demais documentos declarados (o principal está apenas em document), com a mesma estrutura.

version
integer

Versão da entidade. Igual ao cabeçalho ETag; envie-o de volta como If-Match no PATCH.

Exemplo:

1

createdAt
string<date-time>

Carimbos de data/hora UTC ISO 8601.

Exemplo:

"2024-01-15T17:18:53Z"

updatedAt
string<date-time>

Carimbos de data/hora UTC ISO 8601.

Exemplo:

"2024-01-15T17:19:23Z"

customFieldSchemaVersion
integer

Versão do esquema de campos personalizados usado para validar atributos, ou nulo.

Exemplo:

9

Última modificação em 10 de novembro de 2026