O envio de Pix por chave é o método mais comum e seguro. Ele utiliza o DICT (Diretório de Identificadores de Contas Transacionais) do Banco Central para traduzir uma chave (como CPF ou E-mail) em dados bancários completos, realizando verificações antifraude automaticamente.
🛠️ Fluxo de Integração (2 Passos)
Passo 1: Consulta DICT
Antes de pagar, você deve obrigatoriamente realizar a chamada de Consulta de Chave Pix.
Por que fazer? Para exibir ao seu cliente o nome do recebedor e o banco antes dele confirmar o envio, evitando erros e transferências indevidas.
O que ela retorna: O JSON de resposta trará os dados bancários (
account,branch,bank) e o CPF/CNPJ mascarado do titular.
Passo 2: Iniciar o Pagamento
Com os dados da consulta em mãos, utilize o endpoint de Pagamento Pix com as seguintes definições:
initiationType: Defina como "DICT" (indica que a origem foi uma chave).-
creditParty: Preencha com os dados retornados na consulta do Passo 1:participant➡️ Vincule ao código do banco (bank).accountNumber➡️ Vincule ao número da conta (account).taxIdNumber➡️ Vincule ao documento do recebedor (taxId).
amount: Valor da transferência.clientCode: Seu identificador único para controle de duplicidade.paymentType: Utilize "IMMEDIATE".urgency: Utilize "HIGH".
💡 Exemplo de Estrutura JSON
JSON
{
"amount": 50.00,
"clientCode": "TRANSF-998877",
"initiationType": "DICT",
"paymentType": "IMMEDIATE",
"creditParty": {
"participant": "12345678",
"accountNumber": "0001112223",
"taxIdNumber": "000.000.000-00",
"key": "chave@email.com"
}
}
✅ Vantagens de usar o initiationType DICT
Segurança Avançada: A consulta prévia garante que o dinheiro vá para o destino correto.
Conformidade: Segue rigorosamente os ritos de passagem do Banco Central para transações via chave.
Experiência do Usuário: Permite que o pagador confira os dados do destinatário antes de digitar a senha ou confirmar a transação.
🔗 Documentação Completa: Para detalhes técnicos sobre os endpoints de consulta e pagamento, acesse o nosso Portal de Developers.
Comentários
0 comentário
Artigo fechado para comentários.