PIX
Como criar uma cobrança via PIX e o que muda entre provedores de pagamento.
A Agnozys cria cobranças via PIX através da camada de abstração de
pagamentos (PaymentAbstractionLayer), que despacha a cobrança para o
provedor conectado pela sua organização — Asaas, Stark Bank ou Banco
Inter. O fluxo de criação é o mesmo independente do provedor; o que muda
é a capacidade de fazer split nativo (veja o aviso abaixo).
Criar uma cobrança PIX
Acesse Cobranças na barra lateral e clique em Nova Cobrança.
No passo Cliente, selecione um cliente já cadastrado na aba Existente, ou cadastre um novo na aba Novo informando nome, e-mail e CPF/CNPJ.
No passo Cobrança, informe o valor, marque PIX em Formas de pagamento e defina a data de vencimento. A descrição é opcional.
No passo Opções, defina se a nota fiscal deve ser emitida automaticamente após a confirmação do pagamento e, se aplicável, configure o split da cobrança. Clique em Criar Cobrança.
A cobrança é criada com status Pendente e aparece imediatamente na lista de cobranças.
Clique na cobrança para ver os detalhes — cliente, valor, vencimento e status — e acompanhar a confirmação do pagamento.
Quando o pagamento é confirmado pelo provedor (via webhook), o status muda automaticamente para Confirmada e, se configurado, a nota fiscal é emitida.
Split nativo depende do provedor
O split de uma cobrança PIX só é executado de forma nativa (o provedor divide o valor no momento do pagamento) quando o provedor conectado é a Asaas. Com Stark Bank ou Banco Inter, o PIX é suportado, mas o split roda no modo orquestrado ou manual — a Agnozys transfere a parte de cada recebedor depois da confirmação do pagamento, não no ato. Isso não muda o fluxo de criação da cobrança, mas afeta o tempo até cada recebedor receber sua parte.
Métodos de pagamento combinados
Uma cobrança pode aceitar mais de um método de pagamento ao mesmo tempo — por exemplo, PIX e Boleto juntos. O cliente escolhe como pagar na hora de acessar o link da cobrança.