Skip to main content
Enviar dinheiro via Pix pode ser iniciado de formas diferentes dependendo da informação que você tem disponível: uma chave Pix, os dados bancários da conta destino, ou um QR Code com o payload de cobrança. Independentemente da forma de iniciação, todos os pagamentos são executados pelo mesmo endpoint — POST /transfers. O que muda é a etapa de inicialização anterior (quando necessária) e o valor do campo initiationType enviado no corpo da transferência.

​
Formas de iniciação disponíveis

Por chave Pix

Você tem a chave Pix do recebedor (CPF, CNPJ, e-mail, telefone ou EVP). A API consulta o DICT e retorna os dados da conta antes de executar o pagamento.

Por dados bancários

Você tem os dados completos da conta destino (banco, agência, conta, CPF/CNPJ). Não há etapa de inicialização — o pagamento é executado diretamente.

Por QR Code

Você tem o payload de um QR Code (estático ou dinâmico). A API decodifica o payload, retorna os dados da cobrança e você executa o pagamento.

​
Qual forma usar?

​
Como funciona o fluxo

A resposta do POST /transfers indica que o pagamento foi enfileirado, não que já foi liquidado. O status final (PIX_EFFECTIVE ou PIX_ERROR) chega via webhook. Não use polling como mecanismo principal de confirmação.

​
Status do pagamento

​
Consultar um pagamento

Você pode consultar o status de qualquer pagamento a qualquer momento usando o endToEndId ou a IdempotencyKey da requisição original. Veja Consultar Pagamento.

​
Próximos passos

Pagar via chave Pix

Consulte a chave no DICT e execute a transferência.

Pagar via dados bancários

Envie diretamente para uma conta sem precisar de chave.

Pagar via QR Code

Decodifique um payload e execute o pagamento da cobrança.

Consultar pagamento

Consulte o status de transferências Pix, TED e devoluções.