Faturas
Pagar uma fatura
Cobra uma invoice ou registra um pagamento recebido fora da Chargefy.
Se a invoice estiver em
Cria uma tentativa de pagamento para uma invoice
draft, esta ação valida os dados e a finaliza antes de prosseguir. Se o total ficar zerado após créditos, ela fica paid, sem criar uma cobrança.
Cobranças positivas precisam satisfazer o mínimo do plano efetivo e do método.
Um valor insuficiente retorna
amount_too_small antes do processamento e não
autoriza repetição automática. Veja mínimos e tratamento do erro.open vinculada a uma
subscription. A resposta retorna a invoice completa já apontando para o
payment_intent criado. O resultado final da cobrança chega pelos eventos
payment.intent.* e invoice.*.
Use este endpoint para cobrança server-to-server de invoices de assinatura.
Para emitir boleto de uma invoice avulsa ou de assinatura, use
issue_boleto. Este endpoint pay usa
um cartão salvo. A página hosted_invoice_url continua disponível para o
cliente escolher como pagar.
Se o cliente já pagou por fora, envie paid_out_of_band: true para registrar
o pagamento sem cobrá-lo. Veja
pagamento recebido fora da Chargefy.
Payment method salvo (
pm_*) para esta tentativa. Quando omitido, a Chargefy
resolve o método na ordem: default_payment_method da invoice,
default_payment_method da subscription, e default_payment_method do
customer. Não pode ser combinado com paid_out_of_band.Quando
true, marca a invoice como paga sem cobrar o cliente. Use quando o
valor foi recebido fora da Chargefy. Veja
pagamento recebido fora da Chargefy.Pagamento recebido fora da Chargefy
Quando o cliente paga por fora, como em dinheiro em espécie ou por transferência direta para a conta da sua organização, enviepaid_out_of_band: true. A invoice passa a paid sem nenhuma cobrança ao
cliente. Isso vale para qualquer invoice open, inclusive avulsa.
O que acontece:
- A invoice fica
paid, compaid_out_of_band: true,amount_paidigual aamount_dueeamount_remainingzerado. Multa e juros por atraso não são calculados: o valor combinado fora da Chargefy é assunto entre você e o cliente. - O
payment_intentda invoice é cancelado comcancellation_reason: "automatic", e as retentativas e lembretes agendados param. - Se a invoice pertence a uma subscription
past_dueouunpaid, a subscription volta aactive, igual a uma invoice paga pela Chargefy. - Os eventos
invoice.paid,payment.intent.cancelede, quando o status muda,subscription.updatedsão entregues normalmente. - Nenhuma transação, taxa ou repasse é gerado. O valor não entra no seu saldo na Chargefy.

