Actualizar clave PIX
Actualiza los vínculos mutables de una clave PIX (cuenta y nombre del titular/nombre comercial) y reporta el cambio al DICT de BACEN (updateEntry firmado). keyType y ownerTaxId son inmutables; un intento de cambiarlos es rechazado.
Autorizaciones
JWT bearer token issued by the identity provider.
Parámetros de ruta
PIX key value to update (the immutable identifier).
Cuerpo
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"
Respuesta
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"

