Como realizar um Pix Cash-out via Dados Bancários (Manual)

Realizar um Pix utilizando dados bancários (Agência e Conta) é a alternativa ideal para quando o recebedor não possui uma chave Pix cadastrada ou prefere não compartilhá-la. Na Celcoin, essa operação é identificada pelo tipo de iniciação MANUAL.

🛠️ Passo a Passo da Integração

Utilize o endpoint de Pagamento Pix e configure o corpo da requisição com os seguintes parâmetros obrigatórios:

1. Informações da Transação

• amount: Valor a ser transferido (ex: 100.50).

• clientCode: Seu identificador exclusivo para evitar duplicidade.

• initiationType: Defina como "MANUAL" (indica que não haverá consulta de chave no DICT).

• paymentType: Utilize "IMMEDIATE" para liquidação instantânea.

• urgency: Utilize "HIGH".

• transactionType: Utilize "TRANSFER".

2. Identificação das Partes

• debitParty: Dados da sua conta origem (Conta Bolsão Celcoin).

• creditParty: Este é o objeto mais importante para esta modalidade. Você deve preencher:

  • Nome Completo/Razão Social do recebedor.

  • CPF ou CNPJ do recebedor.

  • Código ISPB do banco de destino.

  • Agência e Número da Conta (com dígito).

  • Tipo de conta (ex: CACC para Corrente ou SVGS para Poupança).

💡 Exemplo Estruturado (JSON)

{
  "amount": 150.00,
  "clientCode": "PEDIDO-12345",
  "initiationType": "MANUAL",
  "paymentType": "IMMEDIATE",
  "creditParty": {
    "bank": "00000000", 
    "accountType": "CACC",
    "accountNumber": "123456",
    "branchCode": "0001",
    "taxNumber": "00000000000",
    "name": "Nome do Recebedor"
  }
}

✅ Vantagens deste modelo

• Flexibilidade: Permite pagar qualquer conta bancária no Brasil que aceite Pix.

• Segurança: A Celcoin valida a estrutura dos dados antes do envio ao Banco Central.

• Conciliação: Assim como no Pix via chave, você recebe o End-to-End ID para rastreio total da operação.

⚠️ Atenção: Certifique-se de que o CPF/CNPJ informado pertence ao titular da conta de destino, caso contrário, a transação será rejeitada pela instituição recebedora.

Para mais informações sobre essa operação e o diagrama de uso, consulte nossa documentação.