Cobranças
Toda cobrança é uma fatura, com a própria página de pagamento em url, e cada tentativa de pagar fica registrada dentro dela.
Como cobrar
Crie a fatura e mande a url ao cliente, que escolhe como pagar na página.
Crie a fatura e cobre o cartão na mesma chamada, com o resultado na resposta.
Vender no PixCrie a fatura com o copia e cola do Pix pronto para mostrar ao comprador.
Pagar uma faturaFaça uma nova tentativa na fatura em aberto, depois de uma recusa ou com outro meio.
Consultar faturasConfira o status e as tentativas de uma fatura ou concilie as cobranças pela lista.
Cancelar uma faturaFeche a fatura em aberto que não deve mais ser paga.
Status da fatura
| Status | O que significa | Pode seguir para |
|---|---|---|
pending | Em aberto, recebendo tentativas. | paid, canceled, expired |
paid | Paga no cartão ou no Pix. | refunded, chargedback |
canceled | Cancelada por você ou junto com a assinatura. | paid, pending |
expired | Chegou a billing.expires_at sem pagamento. | paid |
refunded | Estornada. | - |
chargedback | Contestada. | - |
A fatura canceled ou expired só volta a paid quando um pagamento já iniciado é confirmado depois, como um Pix pago com o QR Code ainda válido. A fatura cancelada junto com a assinatura volta a pending se a assinatura for reativada antes do vencimento dela. As faturas não dependem da Recorrência ligada na conta.
Libere o pedido só com a fatura paga.
Leia o status da fatura no evento invoice.paid ou na consulta. Uma tentativa recusada não fecha a fatura: ela segue pending e aceita nova tentativa até billing.expires_at.