Documentação
DocumentaçãoAPIStatusSuporteFAQscelcoin.com

Consultar Chaves Pix Externa (DICT)

Consultar uma chave Pix para uma conta

Suggest Edits

Com essa chamada você consultará uma chave externa Pix e consequentemente irá gerar um endtoend para uma futura transação.

📘

Glossário

DICT -> O Diretório de Identificadores de Contas Transacionais - é o serviço do arranjo Pix que permite buscar detalhes de contas transacionais com chaves de endereçamento mais convenientes para quem faz um pagamento. Entre os tipos de chave atualmente disponíveis estão CPF, CNPJ, telefone, e-mail e EVP.

Entenda o comportamento desse endpoint

Esse endpoint adota um “sistema de baldes e fichas" em conformidade com o Manual Operacional do DICT (seção 13: “mecanismos de prevenção a ataques de leitura”).

Para entender o funcionamento, acesse aqui.

Passos para Integrar

  1. Realizar autenticação na API - [API Reference]
  2. Consultar Chaves Pix Externa- [API Reference]

Consultar chaves Pix Externa (DICT)


Chaves para Testes

CPF -> 77517432125

Email-> [email protected]

Telefone -> +5532976886942


Verificação de Propriedade da Chave Pix


Ao enviar o parâmetro ownerTaxId na requisição de consulta, validaremos se o proprietário da chave é o mesmo que o titular da conta, o que permitirá identificar se a transferência via Pix é feita entre titulares iguais ou não.

Retorno do campo isSameTaxId:
Na resposta da consulta, temos o campo isSameTaxId, que indicará se o taxId da chave é igual ao ownerTaxId enviado na requisição:

true: Se os documentos forem iguais.
false: Se os documentos forem diferentes.



cURL da chamada

curl --location --request GET 'https://sandbox.openfinance.celcoin.dev/baas/v2/pix/dict/entry/external/30054065526?key=77517432125&ownerTaxId=19702369061&includeStatistics=true' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}'

Exemplo de retorno

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": "CONFIRMED",
  "body": {
    "keyType": "string",
    "key": "string",
    "account": {
      "participant": "30306294",
      "branch": "0001",
      "account": "10545584",
      "accountType": "TRAN",
      "createDate": "2020-11-03T06:30:00-03:00"
    },
    "owner": {
      "type": "NATURAL_PERSON",
      "documentNumber": "93179848006",
      "name": "Carlos Silva",
      "tradeName": "Carlos Silva"
    },
    "endtoEndId": "string",
    "creationDate": "2025-04-09T19:18:02.819Z",
    "keyOwnershipDate": "2025-04-09T19:18:02.819Z",
    "openClaimCreationDate": "2025-04-09T19:18:02.819Z",
    "statistics": {
      "ownerStatistics": {
        "spi": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "settlements": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "fraudMarkers": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "applicationFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "muleAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "scammerAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "otherFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "unknownFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "totalFraudTransactionAmount": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "distinctFraudReporters": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "infractionReports": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "openReports": 0,
          "openReportsDistinctReporters": 0,
          "rejectedReports": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "entries": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "registeredAccounts": 0,
          "distinctAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        }
      },
      "keyStatistics": {
        "spi": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "settlements": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "fraudMarkers": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "applicationFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "muleAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "scammerAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "otherFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "unknownFrauds": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "totalFraudTransactionAmount": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          },
          "distinctFraudReporters": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "infractionReports": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "openReports": 0,
          "openReportsDistinctReporters": 0,
          "rejectedReports": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        },
        "entries": {
          "watermark": "2025-04-09T19:18:02.819Z",
          "registeredAccounts": 0,
          "distinctAccounts": {
            "d90": 0,
            "m12": 0,
            "m60": 0
          }
        }
      }
    },
    "isSameTaxId": true
  }
}

❗

Error 400

{
  "version": "1.0.0",
  "status": "ERROR",
  "error": {
    "errorCode": "CBE177",
    "message": "Operação não permitida. Conta esta bloqueada"
  }
}

Tabela de errorCode

CodeMessage
CBE091É necessário informar pelo menos um dos campos: id, clientCode, ou endtoendId.
CBE039Account invalido.
CBE175Cadastro de chave não permitido. Verifique o formato da chave informada
CBE041Account possui tamanho maximo de 20 caracteres
CBE174O Campo key não pode ultrapassar 77 caracteres
CBE176Operação não permitida. Conta esta encerrada
CBE177Operação não permitida. Conta esta bloqueada
CBE190Operação Não permitida. Chave não esta vinculada a essa conta.

Updated 29 days ago