Skip to navigation

Cadastro do titular

O endereço da conta é o endereço do titular no liquidante. Pessoa física altera na hora. Pessoa jurídica abre um pedido e a mesa só grava depois do comprovante.

Ler

GET /v1/accounts/{accountId}/holder devolve nome, documento e endereço ao vivo. A resposta leva Cache-Control: no-store. Escopo holder.read.

Pessoa física

PUT /v1/accounts/{accountId}/holder/address só quando o documento da conta é CPF e X-Acting-Document é esse mesmo CPF. O cityIbgeCode tem de bater com a UF. Não move dinheiro e não pede Idempotency-Key.

Conta PJ nesta rota responde 422 holder_update_required.

Pessoa jurídica

POST /v1/accounts/{accountId}/holder-updates com Idempotency-Key.

kinddocumento obrigatório
addresscompany_proof_of_address
registrationcompany_articles (CNPJ, documento do sócio e outros são opcionais)

O arquivo sobe pela URL assinada (evidence/upload-url e evidence/add), PDF, JPEG ou PNG até 5 MB. submit só conta arquivo com scanStatus APPROVED. Aprovar um pedido de endereço é o que chama o liquidante; se o liquidante recusar, o pedido continua em análise.

Pedido parado em documento por 7 dias é cancelado (holder_update.updated com reason=expired).

O webhook não traz o endereço. Leia de novo o GET.