Alteração de nome em uma chave Pix

Essa funcionalidade permite que os clientes da Celcoin consigam atualizar dados de uma chave Pix existente vinculada a uma conta PF ou PJ de seus clientes.

Passos para Integrar

Realizar autenticação na API - [API Reference]
Alterar dados de Chaves PIX - [API Reference]

Alterar chaves Pix

cURL da chamada

curl --location --request PUT 'https://apicorp.celcoin.com.br/pix/v1/dict/entry' \
--header 'accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "30054065518",
    "keyType": "CPF"
    "key: 12345678923"
    "Name: teste"
     }'

Exemplos de request

Alteração de Nome ou Nome Social (PF) e Razão Social (PJ)

Neste caso para ambos é utilizado o campo Name

{
    "Account": "300539061873",
    "Key": "[email protected]",
    "Name": "Teste Nome Alterado"
}

Alteração de Nome Fantasia (PJ)

A alteração deverá ser feita no campo "tradeName"

{
  "account": "30053913742139",
  "key": "[email protected]",
  "name": "Lavanderia 2 irmaos ltda",
  "tradeName": "Lavanderia 2 irmaos"
}

Exemplo de retorno

👍
Sucesso 200

{
    "Version": "1.0.0",
    "Body": {
        "Account": {
            "Account": "54545445",
            "Participant": "13935893",
            "Branch": "0001",
            "AccountType": "TRAN",
            "CreateDate": "2025-11-25T16:54:37Z"
        },
        "Owner": {
            "Type": 1,
            "DocumentNumber": "1213123121000156",
            "Name": "EMPRESA 2",
            "TradeName": "TESTES S/A"
        },
        "KeyType": 5,
        "Key": "0c4e990c-6a2b-44fd-a7cc-0db8c3fa5659"
    }
}

❗
Error 400

{
  "version": "string",
  "status": 0,
  "errors": [
    {
      "errorCode": "PBE360",
      "message": "The value 'Name' is invalid.The value must match '^([A-Za-zÀ-ÖØ-öø-ÿ' -]+)$'"
    }
  ]
}

Tabela de errorCode

Code	Message
CBE091	É necessário informar o campo: account.
CBE179	É necessário informar o campo: key.
CBE039	Account invalido.
CBE175	Chave invalida. Verifique o formato da chave informada.
CBE041	Account possui tamanho maximo de 20 caracteres
CBE174	O Campo key não pode ultrapassar 77 caracteres
CBE176	Operação não permitida. Conta esta encerrada
CBE177	Operação não permitida. Conta esta bloqueada
CBE190	Operação Não permitida. Chave não esta vinculada a essa conta.

⚠️
Atenção
Antes de realizar a alteração valide se os dados de Nome, Nome Social, Razão Social e Nome Fantasia estão devidamente atualizados na Receita Federal.