Faturas
As faturas são documentos gerados automaticamente ao final de cada ciclo de uma assinatura. Elas detalham todos os valores referentes à assinatura, como itens e descontos, gerando uma cobrança ao assinante.
Atualizações na Fatura
Após a criação automática de uma fatura, você receberá um
invoice_id, que é um identificador único da fatura. Todas as mudanças nos status das faturas serão notificadas viawebhook, conforme o cadastro que você realizou anteriormente.
Geração de Cobranças
Ao gerar uma fatura, uma ou mais cobranças são automaticamente vinculadas a ela. Isso significa que o valor estabelecido no plano ou na assinatura avulsa se traduz em cobranças correspondentes.
Alterar Método de Pagamento
Essa funcionalidade permite alterar o cartão de crédito ou meio de pagamento associado a uma cobrança não autorizada.
Você poderá realizar a alteração do meio de uma cobrança não autorizada (not_authorized) ou que possua algum status de erro ou falha (with_error ou failed).
Recusa pelo Emissor do Cartão
Quando o emissor do cartão recusa a transação, pode ser devido a razões como saldo insuficiente, limite de crédito ultrapassado, suspeita de atividade fraudulenta, informações incorretas ou problemas técnicos. Em tal cenário, é possível realizar a alteração do cartão ou adicionar um novo método de pagamento, incluindo a opção de utilizar múltiplos meios de pagamento em casos de saldo insuficiente ou limite de crédito ultrapassado.
Atenção
Ao alterar ou incluir um método de pagamento, tanto a assinatura (
subscription) quanto a cobrança (charge) ficarãopendingaguardando o processamento.
Verifique aqui como alterar o cartão de crédito ou meio de pagamento.
Eventos Disponíveis para uma Fatura
Possuímos uma lista de eventos significativos que podem ocorrer em nossa API em relação às faturas. Confira abaixo:
| Evento | Descrição |
|---|---|
invoice.created | Ocorre sempre que uma fatura é criada. |
invoice.updated | Ocorre sempre que uma fatura é atualizada. |
invoice.paid | Ocorre sempre que uma fatura é paga. |
invoice.canceled | Ocorre sempre que uma fatura é cancelada. |
invoice.payment_failed | Ocorre sempre que um pagamento de uma fatura falha. |
Status de uma Fatura
O ciclo de vida de uma fatura passa por várias etapas, refletindo sua criação, atualização ou cancelamento.
| Status | Descrição |
|---|---|
pending | A fatura está pendente e aguardando processamento. |
processing | A fatura está sendo processada. |
paid | A fatura foi paga com sucesso. |
canceled | A fatura foi cancelada e não requer pagamento. |
failed | O pagamento da fatura falhou. |
Status de uma Cobrança
| Status | Descrição |
|---|---|
pending | A cobrança está aguardando o pagamento por parte do cliente ou pagador. |
paid | O pagamento foi efetuado com sucesso e a cobrança foi concluída. |
canceled | A cobrança foi cancelada, indicando que não será mais processada ou aceita. |
processing | A cobrança está em processo de processamento e ainda não foi finalizada. |
failed | O pagamento falhou, indicando que a cobrança não foi autorizada ou não pôde ser processada com sucesso. |
overpaid | O pagamento excedeu o valor devido na cobrança, resultando em um pagamento em excesso. |
underpaid | O pagamento efetuado foi inferior ao valor devido na cobrança, representando um pagamento insuficiente. |
chargeback | A transação foi contestada pelo cliente ou pagador, geralmente resultando na reversão do pagamento. |
Explore detalhadamente as cobranças por meio de nossa API Reference.
Updated 3 months ago