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.
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.