Como realizar um Pix cash-out via chave Pix (DICT)?

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

{
  "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

1. Segurança Avançada: A consulta prévia garante que o dinheiro vá para o destino correto.

2. Conformidade: Segue rigorosamente os ritos de passagem do Banco Central para transações via chave.

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