Como receber pagamentos por PIX
Crie cobranças PIX em BRL, entregue o código copia e cola e confirme o pagamento pelo status oficial.
Como o PIX funciona na integração
O PIX é criado pelo endpoint unificado de pagamentos com o método PIX e moeda BRL. A resposta inclui o código que pode ser apresentado ao pagador como PIX copia e cola.
Do pedido à confirmação
A criação da cobrança gera uma instrução de pagamento, não uma confirmação. Relacione a referência da LeonaPay ao pedido da sua loja e acompanhe a mudança de status.
- Seu backend cria o pagamento com uma chave de API do ambiente correto e uma chave de idempotência única.
- Sua aplicação mostra o código PIX retornado ao pagador.
- O pagador conclui a transferência no aplicativo financeiro.
- Seu sistema libera o pedido somente depois de consultar o pagamento confirmado ou receber o webhook assinado payment.paid.
Cuidados de conciliação
Mantenha o ID do pagamento e sua referência interna. Se uma resposta for incerta por falha de rede, consulte a operação existente antes de gerar outra cobrança e reutilize a mesma idempotência na repetição equivalente.
Disponibilidade, limites, taxas e prazo de liberação são os exibidos para a empresa e o método; não presuma condições iguais para todas as contas.
Precisa de ajuda com o seu caso?
Se a orientação não resolveu, fale com o suporte. Não envie senhas, códigos de acesso ou chaves de API.
Entrar em contato