Atualizar chave PIX
Atualiza os vínculos mutáveis de uma chave PIX (conta e nome do titular/nome fantasia) e reporta a alteração ao DICT do BACEN (updateEntry assinado). keyType e ownerTaxId são imutáveis; uma tentativa de alterá-los é rejeitada.
Autorizações
JWT bearer token issued by the identity provider.
Parâmetros de caminho
PIX key value to update (the immutable identifier).
Corpo
Mutable key fields (account + owner name/trade name) and the update reason; keyType and ownerTaxId are immutable and rejected if changed.
Update reason: USER_REQUESTED (not for EVP keys), BRANCH_TRANSFER, RECONCILIATION, or RFB_VALIDATION.
"BRANCH_TRANSFER"
New account number (account mutable field).
"9988776"
New account type (account mutable field).
"CACC"
New account branch (account mutable field).
"0001"
Immutable: supplying a value differing from the stored keyType is rejected.
"CPF"
New owner legal name (owner mutable field).
"João Silva"
Immutable: supplying a value differing from the stored ownerTaxId is rejected.
"12345678901"
New owner trade name (owner mutable field).
"Silva ME"
New owning participant ISPB (account mutable field).
"12345678"
Resposta
OK
Updated PIX key with its mutable fields applied
Key creation timestamp, RFC 3339 (UTC).
"2025-03-07T14:30:00Z"
Unique PIX key identifier (UUID) assigned by the service.
"550e8400-e29b-41d4-a716-446655440000"
PIX key type: CPF, CNPJ, EMAIL, PHONE, or EVP (random key).
"CPF"
PIX key value in its canonical format for the key type.
"12345678901"
Full legal name of the key owner.
"João Silva"
Owner tax identifier (CPF or CNPJ), digits only.
"12345678901"
Owning participant ISPB, the 8-digit BACEN institution identifier.
"12345678"
Key lifecycle status: ACTIVE, INACTIVE, PENDING_CLAIM, or PENDING_BACEN_SYNC.
"ACTIVE"
Timestamp of the last update to the key, RFC 3339 (UTC).
"2025-03-07T14:30:00Z"
Account number (1..20 digits), omitted for a tuple-less key.
"9988776"
BACEN account type (CACC, TRAN, SLRY, SVGS), omitted for a tuple-less key.
CACC, TRAN, SLRY, SVGS "CACC"
Account branch (1..4 digits), omitted when unset.
"0001"
Account opening date, RFC 3339, omitted for a tuple-less key.
"2020-01-15T00:00:00Z"
Owner trade name (legal-entity owners), omitted when unset.
"Silva ME"

