{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/pt-br/products/payments-direct-2/api-docs/developer-guides/update-an-identity","default":true,"active":true,"folderId":"7e5507fe"},{"version":"v2026.03","label":"v2026.03","link":"/pt-br/products/payments-direct-2/v2026.03/api-docs/developer-guides/update-an-identity","default":false,"active":false,"folderId":"7e5507fe"},{"version":"v2025.11","label":"v2025.11","link":"/pt-br/products/payments-direct-2/v2025.11/api-docs/developer-guides/update-an-identity","default":false,"active":false,"folderId":"7e5507fe"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Atualizar uma identidade","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"atualizar-uma-identidade","__idx":0},"children":["Atualizar uma identidade"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Corredores compatíveis"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para conhecer os corredores de pagamento compatíveis, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/introduction/payout-network"},"children":["Payout network"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este tutorial mostra como usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /v3/identities/{identity-id}"]}," para atualizar uma identidade existente no ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Management v3"]},". Ele cobre a atualização de metadados, campos de PII e validação de payment rail, e explica como funciona o versionamento de identidades e o que isso significa para a sua integração."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"antes-de-começar","__idx":1},"children":["Antes de começar"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para seguir estes exemplos, você precisa de:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["URL base do Identity Management (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://{base-url}"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Um token de acesso com o escopo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["participants:update"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityId"]}," de uma identidade criada anteriormente"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Em todos os exemplos abaixo, substitua:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{base-url}"]}," pela sua URL base de PII real"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<access_token>"]}," por um token de acesso OAuth2 válido"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{identity-id}"]}," por um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityId"]}," real retornado pela API"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-funcionam-as-atualizações-de-identidade","__idx":2},"children":["Como funcionam as atualizações de identidade"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"versionamento-imutável","__idx":3},"children":["Versionamento imutável"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toda chamada bem-sucedida a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /v3/identities/{identity-id}"]}," cria uma ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["nova versão"]}," da identidade. A versão anterior é preservada e continua disponível para consulta e auditoria. O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityId"]}," nunca muda."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Por exemplo, se uma identidade está em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version: 2"]},", uma atualização bem-sucedida produz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version: 3"]},". O registro da versão 2 continua acessível por ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v3/identities/{identity-id}?version=2"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"atualizações-parciais","__idx":4},"children":["Atualizações parciais"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O corpo da requisição PUT aceita atualizações parciais. Você só precisa incluir os campos que quer alterar. Os campos que você omite mantêm os valores atuais."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Por exemplo, para atualizar apenas o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickName"]},", basta enviar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickName"]}," no corpo da requisição. Todos os demais dados de PII e metadados são preservados sem alteração."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"efeito-sobre-os-pagamentos","__idx":5},"children":["Efeito sobre os pagamentos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os pagamentos ficam vinculados a um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityId"]}," e a uma ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," específicos no momento da criação. Atualizar uma identidade cria uma nova versão, mas ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["não afeta os pagamentos que já foram criados"]}," com uma versão anterior. Esses pagamentos continuam referenciando a versão da identidade com que foram criados."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"o-que-você-pode-e-o-que-não-pode-alterar","__idx":6},"children":["O que você pode e o que não pode alterar"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo(s)"},"children":["Campo(s)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pode atualizar?"},"children":["Pode atualizar?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Observações"},"children":["Observações"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Substitui integralmente o array de tags existente"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precisa continuar único entre todas as identidades ACTIVE da sua organização"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatePayoutRails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revalida o PII da identidade contra os rails especificados"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["individual"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Qualquer campo dentro do objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["individual"]}," (endereço, contato, documentos etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Qualquer campo dentro do objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business"]}," (nome, endereço, contato, registro etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Não"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Definido na criação (INDIVIDUAL ou BUSINESS). Não pode ser alterado."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRole"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Não"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Definido na criação (ORIGINATOR ou BENEFICIARY). Não pode ser alterado."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Identidades DEACTIVATED"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Não é possível atualizar uma identidade DEACTIVATED. A desativação é permanente. Se você precisar retomar a atividade de uma parte desativada, crie uma nova identidade."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"atualizar-os-metadados-da-identidade","__idx":7},"children":["Atualizar os metadados da identidade"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os campos de metadados (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nickName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]},") são a atualização mais simples. Nenhuma validação de PII é disparada."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: atualizar o apelido e as tags"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/99254c4f-f207-4792-a846-06928825018c\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"nickName\": \"Alice Chen - Primary USD\",\n    \"tags\": [\"usd\", \"high-value\", \"verified\"]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resposta (200 OK)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identityId\": \"99254c4f-f207-4792-a846-06928825018c\",\n  \"identityState\": \"ACTIVE\",\n  \"version\": \"2\",\n  \"schemaVersion\": \"1.0.0\",\n  \"identityType\": \"INDIVIDUAL\",\n  \"paymentRole\": \"ORIGINATOR\",\n  \"internalId\": \"customer-12345\",\n  \"nickName\": \"Alice Chen - Primary USD\",\n  \"tags\": [\"usd\", \"high-value\", \"verified\"],\n  \"createdAt\": \"2025-10-01T18:46:41.833Z\",\n  \"updatedAt\": \"2026-03-10T09:15:10.000Z\",\n  \"individual\": {\n    \"firstName\": \"Alice\",\n    \"lastName\": \"Chen\",\n    \"dateOfBirth\": \"1990-05-14\",\n    \"citizenship\": \"US\",\n    \"address\": {\n      \"streetAddress\": [\"123 Main Street\"],\n      \"city\": \"San Francisco\",\n      \"stateOrProvince\": \"CA\",\n      \"postalCode\": \"94105\",\n      \"country\": \"US\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Observe que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," passou de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}," e que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]}," reflete o momento da atualização. Todos os demais campos permanecem inalterados."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"As tags são substituídas, não mescladas"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]}," é substituído integralmente a cada atualização. Se você enviar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"tags\": [\"usd\"]"]},", todas as tags anteriores são removidas e substituídas pelo novo valor. Busque a identidade atual antes, se precisar preservar as tags existentes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"atualizar-campos-de-pii","__idx":8},"children":["Atualizar campos de PII"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"atualizar-uma-identidade-individual","__idx":9},"children":["Atualizar uma identidade INDIVIDUAL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use isto para corrigir ou atualizar dados pessoais, como endereço, informações de contato ou documentos de identidade."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: atualizar o endereço"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/99254c4f-f207-4792-a846-06928825018c\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"individual\": {\n      \"address\": {\n        \"streetAddress\": [\"500 Market Street\", \"Suite 200\"],\n        \"city\": \"San Francisco\",\n        \"stateOrProvince\": \"CA\",\n        \"postalCode\": \"94103\",\n        \"country\": \"US\"\n      }\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resposta (200 OK)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identityId\": \"99254c4f-f207-4792-a846-06928825018c\",\n  \"identityState\": \"ACTIVE\",\n  \"version\": \"3\",\n  \"schemaVersion\": \"1.0.0\",\n  \"identityType\": \"INDIVIDUAL\",\n  \"paymentRole\": \"ORIGINATOR\",\n  \"internalId\": \"customer-12345\",\n  \"nickName\": \"Alice Chen - Primary USD\",\n  \"tags\": [\"usd\", \"high-value\", \"verified\"],\n  \"createdAt\": \"2025-10-01T18:46:41.833Z\",\n  \"updatedAt\": \"2026-03-10T10:22:05.000Z\",\n  \"individual\": {\n    \"firstName\": \"Alice\",\n    \"lastName\": \"Chen\",\n    \"dateOfBirth\": \"1990-05-14\",\n    \"citizenship\": \"US\",\n    \"address\": {\n      \"streetAddress\": [\"500 Market Street\", \"Suite 200\"],\n      \"city\": \"San Francisco\",\n      \"stateOrProvince\": \"CA\",\n      \"postalCode\": \"94103\",\n      \"country\": \"US\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"atualizar-uma-identidade-business","__idx":10},"children":["Atualizar uma identidade BUSINESS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: atualizar e-mail e telefone"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/0116bacc-ffbf-4fa2-a29c-ecd9ea346806\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"business\": {\n      \"email\": \"ops@widgetsorg.com\",\n      \"phone\": \"+14155550199\"\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resposta (200 OK)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identityId\": \"0116bacc-ffbf-4fa2-a29c-ecd9ea346806\",\n  \"identityState\": \"ACTIVE\",\n  \"version\": \"2\",\n  \"schemaVersion\": \"1.0.0\",\n  \"identityType\": \"BUSINESS\",\n  \"paymentRole\": \"BENEFICIARY\",\n  \"internalId\": \"counterparty-7890\",\n  \"nickName\": \"Widgets Org MX\",\n  \"tags\": [\"beneficiary\", \"mx\"],\n  \"createdAt\": \"2025-10-01T16:14:13.200Z\",\n  \"updatedAt\": \"2026-03-10T11:05:30.000Z\",\n  \"business\": {\n    \"businessName\": \"Widgets Org\",\n    \"incorporationCountry\": \"US\",\n    \"email\": \"ops@widgetsorg.com\",\n    \"phone\": \"+14155550199\",\n    \"registration\": [\n      {\n        \"number\": \"123ABC\",\n        \"type\": \"INCORPORATION_CERTIFICATE\"\n      }\n    ],\n    \"address\": {\n      \"streetAddress\": [\"123 Example MA\"],\n      \"city\": \"Boston\",\n      \"stateOrProvince\": \"MS\",\n      \"postalCode\": \"12345\",\n      \"country\": \"US\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adicionar-ou-alterar-a-validação-de-payment-rail","__idx":11},"children":["Adicionar ou alterar a validação de payment rail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatePayoutRails"]}," para validar o PII de uma identidade contra payment rails adicionais. Isso é útil quando você está cadastrando um beneficiário em um novo corredor que exige campos de PII específicos."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: adicionar validação de EU SEPA e GB FPS"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/99254c4f-f207-4792-a846-06928825018c\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"validatePayoutRails\": [\"US_ACH\", \"EU_SEPA\", \"GB_FPS\"]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se o PII atual da identidade atender a todos os requisitos dos rails especificados, a atualização é bem-sucedida e retorna a nova versão. Se faltar algum campo obrigatório para qualquer um dos rails especificados, a requisição retorna ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["400 Bad Request"]}," com detalhes por campo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": \"VALIDATION_ERROR\",\n  \"title\": \"Identity validation failed\",\n  \"description\": \"The identity is missing required fields for the specified payment rails.\",\n  \"details\": [\n    {\n      \"field\": \"individual.dateOfBirth\",\n      \"message\": \"Date of birth is required for EU_SEPA beneficiary identities\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para resolver isso, adicione os campos de PII ausentes à mesma requisição de atualização:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/99254c4f-f207-4792-a846-06928825018c\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"validatePayoutRails\": [\"US_ACH\", \"EU_SEPA\", \"GB_FPS\"],\n    \"individual\": {\n      \"dateOfBirth\": \"1990-05-14\"\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"validatePayoutRails é orientativo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incluir um rail em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatePayoutRails"]}," não impede que você adicione instrumentos financeiros para outros rails, e omitir um rail não impede que você o use depois. De qualquer forma, a validação é feita no momento da criação do instrumento financeiro e da iniciação do pagamento."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"atualizar-o-internalid","__idx":12},"children":["Atualizar o internalId"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você pode alterar o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalId"]}," de uma identidade com uma requisição PUT. O novo valor não pode já estar em uso por outra identidade ACTIVE da sua organização."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: renomear um internalId"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/99254c4f-f207-4792-a846-06928825018c\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"internalId\": \"customer-12345-v2\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalId"]}," solicitado já estiver em uso por outra identidade ACTIVE, a requisição retorna ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["409 Conflict"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": \"CONFLICT\",\n  \"title\": \"Identity conflict\",\n  \"description\": \"The provided internalId already exists on a different identity.\",\n  \"details\": [\n    {\n      \"field\": \"internalId\",\n      \"message\": \"An ACTIVE identity with internalId 'customer-12345-v2' already exists (identityId: 7ea3399c-1234-5678-8d8f-d320ea406630)\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para orientações sobre o tratamento de conflitos 409, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities#tratamento-de-conflitos-de-internalid-409-conflict"},"children":["Criar e gerenciar identidades"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"atualizar-uma-identidade-blocked","__idx":13},"children":["Atualizar uma identidade BLOCKED"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Uma identidade pode estar no estado ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLOCKED"]}," se foi sinalizada para análise de compliance ou se foi importada de uma versão anterior da API. Identidades BLOCKED não podem ser usadas para criar novos pagamentos."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Chamar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /v3/identities/{identity-id}"]}," em uma identidade BLOCKED atualiza os dados da identidade ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["e"]}," transiciona o estado dela de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLOCKED"]}," de volta para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Estado BLOCKED e reativação"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um PUT bem-sucedido em uma identidade BLOCKED define ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityState"]}," como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},". Confirme com a sua equipe de compliance que a reativação é adequada antes de enviar uma atualização para uma identidade BLOCKED."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemplo: atualizar uma identidade BLOCKED"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://{base-url}/v3/identities/{identity-id}\" \\\n  -H \"Authorization: Bearer <access_token>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"nickName\": \"Reviewed and cleared\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resposta (200 OK)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identityId\": \"{identity-id}\",\n  \"identityState\": \"ACTIVE\",\n  \"version\": \"3\",\n  ...\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityState"]}," na resposta é ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},", confirmando que a identidade foi reativada como parte da atualização."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"referência-de-erros","__idx":14},"children":["Referência de erros"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status HTTP"},"children":["Status HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Quando ocorre"},"children":["Quando ocorre"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"O que fazer"},"children":["O que fazer"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos ausentes ou inválidos, ou PII reprovado na validação dos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validatePayoutRails"]}," especificados"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifique o array ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details[]"]}," para ver as mensagens por campo. Corrija a requisição e tente novamente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity-id"]}," não existe"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confira o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityId"]}," e tente novamente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalId"]}," da requisição já está em uso por outra identidade ACTIVE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a identidade existente ou escolha outro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalId"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500 Internal Server Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Erro de processamento no lado da Ripple"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tente novamente após um breve intervalo. Entre em contato com o suporte se o erro persistir."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximos-passos","__idx":15},"children":["Próximos passos"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para entender o modelo de dados completo da identidade e o comportamento de versionamento, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/introduction/concepts/payment-identities"},"children":["Identidades do pagamento"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para criar identidades e gerenciar o ciclo de vida completo, incluindo a desativação, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities"},"children":["Criar e gerenciar identidades"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para adicionar ou atualizar dados de conta bancária e de payout de uma identidade, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-financial-instruments"},"children":["Criar e gerenciar instrumentos financeiros"]},"."]}]}]},"headings":[{"value":"Atualizar uma identidade","id":"atualizar-uma-identidade","depth":1},{"value":"Antes de começar","id":"antes-de-começar","depth":2},{"value":"Como funcionam as atualizações de identidade","id":"como-funcionam-as-atualizações-de-identidade","depth":2},{"value":"Versionamento imutável","id":"versionamento-imutável","depth":3},{"value":"Atualizações parciais","id":"atualizações-parciais","depth":3},{"value":"Efeito sobre os pagamentos","id":"efeito-sobre-os-pagamentos","depth":3},{"value":"O que você pode e o que não pode alterar","id":"o-que-você-pode-e-o-que-não-pode-alterar","depth":3},{"value":"Atualizar os metadados da identidade","id":"atualizar-os-metadados-da-identidade","depth":2},{"value":"Atualizar campos de PII","id":"atualizar-campos-de-pii","depth":2},{"value":"Atualizar uma identidade INDIVIDUAL","id":"atualizar-uma-identidade-individual","depth":3},{"value":"Atualizar uma identidade BUSINESS","id":"atualizar-uma-identidade-business","depth":3},{"value":"Adicionar ou alterar a validação de payment rail","id":"adicionar-ou-alterar-a-validação-de-payment-rail","depth":2},{"value":"Atualizar o internalId","id":"atualizar-o-internalid","depth":2},{"value":"Atualizar uma identidade BLOCKED","id":"atualizar-uma-identidade-blocked","depth":2},{"value":"Referência de erros","id":"referência-de-erros","depth":2},{"value":"Próximos passos","id":"próximos-passos","depth":2}],"frontmatter":{"title":"Atualizar uma identidade","toc":{"enable":true,"maxDepth":2},"seo":{"title":"Atualizar uma identidade"}},"lastModified":"2026-10-21T04:11:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments-direct-2/api-docs/developer-guides/update-an-identity","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}