Faturas
Cancelar uma fatura
Cancela uma invoice que ainda não foi paga.
curl -X POST "https://api.chargefy.io/v1/invoices/inv_YKLo3CwvvU8yTZfu/void" \
-H "Authorization: Bearer {{API_KEY}}"
{
"id": "inv_YKLo3CwvvU8yTZfu",
"object": "invoice",
"allow_late_payment": true,
"amount_credit_balance_applied": 0,
"amount_discount": 0,
"amount_due": 12990,
"amount_due_now": 12990,
"amount_paid": 0,
"amount_remaining": 12990,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"attempt_count": 1,
"billing_reason": "manual",
"collection_method": "charge_automatically",
"created_at": "2026-05-19T18:00:00Z",
"currency": "brl",
"customer": "cus_Ek7KhuLZRVAFTomR",
"customer_billing_address": {
"city": "São Paulo",
"country": "BR",
"line1": "Av. Paulista, 1000",
"line2": "Conjunto 101",
"postal_code": "01310-100",
"state": "SP"
},
"customer_billing_name": "Cliente Exemplo",
"customer_document": "12345678901",
"customer_document_type": "cpf",
"customer_email": "nome@email.com",
"customer_name": "Cliente Exemplo",
"default_payment_method": "pm_3ck2HC5HcbB9NQNH",
"description": "Ajuste mensal",
"due_date": "2026-05-19T12:00:00Z",
"ending_balance": 0,
"hosted_invoice_url": "https://billing.chargefy.io/invoice/ilink_8Pz6wKf3tVn2Qa9LmXr4Bc7D",
"interest": {
"percent_per_month": 1
},
"interest_amount": null,
"invoice_pdf_url": "https://billing.chargefy.io/invoice/inv_YKLo3CwvvU8yTZfu.pdf",
"late_fee": {
"type": "fixed",
"value": 200
},
"late_fee_amount": null,
"latest_charge": null,
"line_items": [
{
"id": "ili_CUCbS578X1xNQuuU",
"object": "invoice_line_item",
"amount_discount": 0,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"currency": "brl",
"description": "Ajuste mensal",
"discountable": true,
"metadata": {},
"period_end": null,
"period_start": null,
"position": 0,
"price": null,
"price_data": {
"currency": "brl",
"unit_amount": 12990
},
"product": null,
"proration": false,
"proration_details": {},
"quantity": 1,
"recurring_interval": null,
"recurring_interval_count": null,
"subscription_item": null,
"unit_amount": 12990
}
],
"livemode": true,
"marked_uncollectible_at": null,
"metadata": {},
"next_payment_attempt": null,
"number": "K7M2-0001",
"paid_at": null,
"payment_intent": null,
"payment_method_types": [
"credit_card"
],
"starting_balance": 0,
"statement_descriptor": "AJUSTE MENSAL",
"status": "void",
"subscription": "sub_d5qgmQKpt63LzZRi",
"updated_at": "2026-05-19T18:05:00Z",
"voided_at": "2026-05-19T18:05:00Z"
}
Marca uma invoice
open como void. Invoices pagas não podem ser canceladas
por este endpoint; use o fluxo apropriado da cobrança quando precisar devolver
um pagamento já capturado.
Quando uma invoice é cancelada, uma URL ativa em hosted_invoice_url continua
apontando para a página da invoice, mas ela fica apenas para visualização e não
aceita pagamento.
string
required
ID da invoice (
inv_*).curl -X POST "https://api.chargefy.io/v1/invoices/inv_YKLo3CwvvU8yTZfu/void" \
-H "Authorization: Bearer {{API_KEY}}"
{
"id": "inv_YKLo3CwvvU8yTZfu",
"object": "invoice",
"allow_late_payment": true,
"amount_credit_balance_applied": 0,
"amount_discount": 0,
"amount_due": 12990,
"amount_due_now": 12990,
"amount_paid": 0,
"amount_remaining": 12990,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"attempt_count": 1,
"billing_reason": "manual",
"collection_method": "charge_automatically",
"created_at": "2026-05-19T18:00:00Z",
"currency": "brl",
"customer": "cus_Ek7KhuLZRVAFTomR",
"customer_billing_address": {
"city": "São Paulo",
"country": "BR",
"line1": "Av. Paulista, 1000",
"line2": "Conjunto 101",
"postal_code": "01310-100",
"state": "SP"
},
"customer_billing_name": "Cliente Exemplo",
"customer_document": "12345678901",
"customer_document_type": "cpf",
"customer_email": "nome@email.com",
"customer_name": "Cliente Exemplo",
"default_payment_method": "pm_3ck2HC5HcbB9NQNH",
"description": "Ajuste mensal",
"due_date": "2026-05-19T12:00:00Z",
"ending_balance": 0,
"hosted_invoice_url": "https://billing.chargefy.io/invoice/ilink_8Pz6wKf3tVn2Qa9LmXr4Bc7D",
"interest": {
"percent_per_month": 1
},
"interest_amount": null,
"invoice_pdf_url": "https://billing.chargefy.io/invoice/inv_YKLo3CwvvU8yTZfu.pdf",
"late_fee": {
"type": "fixed",
"value": 200
},
"late_fee_amount": null,
"latest_charge": null,
"line_items": [
{
"id": "ili_CUCbS578X1xNQuuU",
"object": "invoice_line_item",
"amount_discount": 0,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"currency": "brl",
"description": "Ajuste mensal",
"discountable": true,
"metadata": {},
"period_end": null,
"period_start": null,
"position": 0,
"price": null,
"price_data": {
"currency": "brl",
"unit_amount": 12990
},
"product": null,
"proration": false,
"proration_details": {},
"quantity": 1,
"recurring_interval": null,
"recurring_interval_count": null,
"subscription_item": null,
"unit_amount": 12990
}
],
"livemode": true,
"marked_uncollectible_at": null,
"metadata": {},
"next_payment_attempt": null,
"number": "K7M2-0001",
"paid_at": null,
"payment_intent": null,
"payment_method_types": [
"credit_card"
],
"starting_balance": 0,
"statement_descriptor": "AJUSTE MENSAL",
"status": "void",
"subscription": "sub_d5qgmQKpt63LzZRi",
"updated_at": "2026-05-19T18:05:00Z",
"voided_at": "2026-05-19T18:05:00Z"
}
⌘I
curl -X POST "https://api.chargefy.io/v1/invoices/inv_YKLo3CwvvU8yTZfu/void" \
-H "Authorization: Bearer {{API_KEY}}"
{
"id": "inv_YKLo3CwvvU8yTZfu",
"object": "invoice",
"allow_late_payment": true,
"amount_credit_balance_applied": 0,
"amount_discount": 0,
"amount_due": 12990,
"amount_due_now": 12990,
"amount_paid": 0,
"amount_remaining": 12990,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"attempt_count": 1,
"billing_reason": "manual",
"collection_method": "charge_automatically",
"created_at": "2026-05-19T18:00:00Z",
"currency": "brl",
"customer": "cus_Ek7KhuLZRVAFTomR",
"customer_billing_address": {
"city": "São Paulo",
"country": "BR",
"line1": "Av. Paulista, 1000",
"line2": "Conjunto 101",
"postal_code": "01310-100",
"state": "SP"
},
"customer_billing_name": "Cliente Exemplo",
"customer_document": "12345678901",
"customer_document_type": "cpf",
"customer_email": "nome@email.com",
"customer_name": "Cliente Exemplo",
"default_payment_method": "pm_3ck2HC5HcbB9NQNH",
"description": "Ajuste mensal",
"due_date": "2026-05-19T12:00:00Z",
"ending_balance": 0,
"hosted_invoice_url": "https://billing.chargefy.io/invoice/ilink_8Pz6wKf3tVn2Qa9LmXr4Bc7D",
"interest": {
"percent_per_month": 1
},
"interest_amount": null,
"invoice_pdf_url": "https://billing.chargefy.io/invoice/inv_YKLo3CwvvU8yTZfu.pdf",
"late_fee": {
"type": "fixed",
"value": 200
},
"late_fee_amount": null,
"latest_charge": null,
"line_items": [
{
"id": "ili_CUCbS578X1xNQuuU",
"object": "invoice_line_item",
"amount_discount": 0,
"amount_subtotal": 12990,
"amount_tax": 0,
"amount_total": 12990,
"currency": "brl",
"description": "Ajuste mensal",
"discountable": true,
"metadata": {},
"period_end": null,
"period_start": null,
"position": 0,
"price": null,
"price_data": {
"currency": "brl",
"unit_amount": 12990
},
"product": null,
"proration": false,
"proration_details": {},
"quantity": 1,
"recurring_interval": null,
"recurring_interval_count": null,
"subscription_item": null,
"unit_amount": 12990
}
],
"livemode": true,
"marked_uncollectible_at": null,
"metadata": {},
"next_payment_attempt": null,
"number": "K7M2-0001",
"paid_at": null,
"payment_intent": null,
"payment_method_types": [
"credit_card"
],
"starting_balance": 0,
"statement_descriptor": "AJUSTE MENSAL",
"status": "void",
"subscription": "sub_d5qgmQKpt63LzZRi",
"updated_at": "2026-05-19T18:05:00Z",
"voided_at": "2026-05-19T18:05:00Z"
}