O que é o Pix Cash-out?

Essa funcionalidade permite que os participantes indiretos da Celcoin consigam efetuar pagamentos ou transferências para qualquer instituição financeira utilizando as integrações do Pix Indireto.
Existem algumas maneiras de realizar esses procedimentos. Abaixo apresentamos cada uma e explicamos um pouco mais sobre elas, basta acessar os links abaixo:

Gerar endToEndId para iniciar um pagamento

Realizar uma transferência Pix com dados bancários de um usuário

Essa API permite que seja realizada a iniciação de um pagamento Pix a partir das regras populadas em seu payload.

Regras de preenchimento e validação conforme o 'TransactionType':

TRANSFER:
• 'vlcpAmount', 'vldnAmount', 'withdrawalAgentMode' e 'withdrawalServiceProvider' não devem ser preenchidos.

WITHDRAWAL:
• 'vlcpAmount' não deve ser preenchido, 'vldnAmount', 'withdrawalAgentMode' e 'withdrawalServiceProvider' devem ser preenchidos.

CHANGE:
• 'vlcpAmount', 'vldnAmount', 'withdrawalAgentMode' e 'withdrawalServiceProvider' devem ser preenchidos.

Regras de preenchimento e validação conforme o 'InitiationType':

MANUAL:
• 'transactionIdentification' deve ser nulo
• 'creditParty.key' deve ser nulo
• 'endToEndId' deve ser preenchido com o identificador gerado peloPOST /payment/endToEnd .

DICT:
• 'transactionIdentification' deve ser nulo
• 'creditParty.key' deve ser preenchido
• 'endToEndId' deve ser preenchido com o mesmo endToEndId da consulta ao DICT.

STATIC_QRCODE:
• 'transactionIdentification' deve ser preenchido com o identificador do QR Code contendo até 25 caracteres
• 'creditParty.key' deve ser preenchido
• 'endToEndId' deve ser preenchido com o mesmo endToEndId da consulta ao DICT.

DYNAMIC_QRCODE:
• 'transactionIdentification' deve ser preenchido com o identificador do QR Code contendo de 26 até 35 caracteres
• 'creditParty.key' deve ser preenchido
• 'endToEndId' deve ser preenchido com o mesmo endToEndId da consulta ao DICT.

PAYMENT_INITIATOR:
• 'transactionIdentification' deve ser preenchido de acordo com a regra de pagamento de STATIC_QRCODE
• 'creditParty.key' deve ser preenchido caso exista uma consulta DICT pré-pagamento
• 'taxIdPaymentInitiator' deve ser preenchido com um CNPJ (14 caracteres)
• 'endToEndId' deve ser preenchido com o mesmo endToEndId da consulta ao DICT.

Regras de preenchimento e validação conforme o 'PaymentType':

IMMEDIATE: pagamentos que deverão ser efetuados imediatamente, no ato da solicitação pelo usuário pagador
• 'urgency' deve ser preenchido com HIGH.

FRAUD: usado para pagamento por suspeita de fraude
• 'urgency' deve ser preenchido com NORMAL.

SCHEDULED: transações que não serão realizadas imediatamente, como no caso de pagamentos agendados.
• 'urgency' deve ser preenchido com NORMAL.

❗️

Com a alteração definida pela Circular BCB nº 501, o Banco Central passou a impedir, a partir de 04/10/2025, o retorno de dados de chaves Pix que estejam marcadas como suspeitas de fraude no DICT. Isso significa que, sempre que uma nova chave com essa marcação for consultada, o DICT não retornará informações do titular ou da conta vincula

Exemplo de retorno com chave marcada com fraude

{
"code":"422",
"description":"Chave Pix com dados restritos por marcação de fraude."
}