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 de request

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

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

Alteração de Razão Social e Nome Fantasia

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

Exemplo de retorno

👍
Sucesso 200

{
  "version": "1.0.0",
  "status": "CONFIRMED",
  "body": {
    "keyType": "CNPJ",
    "key": "12345698000100",
    "account": {
      "participant": "30306294",
      "branch": "0001",
      "account": "10545584",
      "accountType": "TRAN",
      "createDate": "2020-11-03T06:30:00-03:00"
    },
    "owner": {
      "type": "BUSINESS",
      "documentNumber": "12365478000100",

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