--- updatedAt: 2025-10-31T16:42:58.000Z agentTools: projectIndex: https://dev.iugu.com/llms.txt --- # Cancelar Fatura Cancela uma Fatura. Os status possíveis para cancelamento: Em análise, pendente e expirada. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "faturas", "version": "1.0" }, "servers": [ { "url": "https://api.iugu.com/v1" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "api_token", "in": "query" } } }, "security": [ { "sec0": [] } ], "paths": { "/invoices/{id}/cancel": { "put": { "summary": "Cancelar Fatura", "description": "Cancela uma Fatura. Os status possíveis para cancelamento: Em análise, pendente e expirada.", "operationId": "cancelar", "parameters": [ { "name": "id", "in": "path", "description": "ID da Fatura", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"id\": \"EBB161AAB22849BFA047D5F1DF55AEE9\",\n \"due_date\": \"2025-04-02\",\n \"currency\": \"BRL\",\n \"discount_cents\": 24,\n \"email\": \"email@iugu.com\",\n \"items_total_cents\": 400,\n \"notification_url\": null,\n \"return_url\": \"https://google.com\",\n \"status\": \"canceled\",\n \"tax_cents\": null,\n \"total_cents\": 376,\n \"total_paid_cents\": 0,\n \"taxes_paid_cents\": null,\n \"paid_at\": null,\n \"paid_cents\": null,\n \"cc_emails\": null,\n \"financial_return_date\": null,\n \"payable_with\": \"all\",\n \"overpaid_cents\": null,\n \"ignore_due_email\": null,\n \"ignore_canceled_email\": null,\n \"advance_fee_cents\": null,\n \"commission_cents\": null,\n \"early_payment_discount\": false,\n \"order_id\": null,\n \"updated_at\": \"2025-04-02T13:14:27-03:00\",\n \"credit_card_brand\": null,\n \"credit_card_bin\": null,\n \"credit_card_last_4\": null,\n \"credit_card_captured_at\": null,\n \"credit_card_tid\": null,\n \"external_reference\": null,\n \"max_installments_value\": null,\n \"payer_name\": \"John\",\n \"payer_email\": null,\n \"payer_cpf_cnpj\": \"11343675030\",\n \"payer_phone\": \"971113024\",\n \"payer_phone_prefix\": \"11\",\n \"payer_address_zip_code\": \"13056-344\",\n \"payer_address_street\": \"Rua Antônio Nunes\",\n \"payer_address_district\": \"Dic I (Conjunto Habitacional Monsenhor Luiz Fernando Abreu)\",\n \"payer_address_city\": \"Campinas\",\n \"payer_address_state\": \"SP\",\n \"payer_address_number\": \"21\",\n \"payer_address_complement\": \"AP1702\",\n \"payer_address_country\": \"Brasil\",\n \"late_payment_fine\": 0,\n \"late_payment_fine_cents\": null,\n \"split_id\": \"3270D0BAB8074BDE98E382340338550C\",\n \"external_payment_id\": null,\n \"external_payment_description\": null,\n \"payment_booklet_id\": null,\n \"subscription_id\": null,\n \"variables\": [\n {\n \"variable\": \"barcode_v1\",\n \"value\": \"40197103900000003762025092000000000000200864\"\n },\n {\n \"variable\": \"barcode_version\",\n \"value\": \"1\"\n },\n {\n \"variable\": \"payer.address.city\",\n \"value\": \"Campinas\"\n },\n {\n \"variable\": \"payer.address.complement\",\n \"value\": \"AP1702\"\n },\n {\n \"variable\": \"payer.address.country\",\n \"value\": \"Brasil\"\n },\n {\n \"variable\": \"payer.address.district\",\n \"value\": \"Dic I (Conjunto Habitacional Monsenhor Luiz Fernando Abreu)\"\n },\n {\n \"variable\": \"payer.address.number\",\n \"value\": \"21\"\n },\n {\n \"variable\": \"payer.address.state\",\n \"value\": \"SP\"\n },\n {\n \"variable\": \"payer.address.street\",\n \"value\": \"Rua Antônio Nunes\"\n },\n {\n \"variable\": \"payer.address.zip_code\",\n \"value\": \"13056-344\"\n },\n {\n \"variable\": \"payer.cpf_cnpj\",\n \"value\": \"11343675030\"\n },\n {\n \"variable\": \"payer.name\",\n \"value\": \"John\"\n },\n {\n \"variable\": \"payer.phone\",\n \"value\": \"971113024\"\n },\n {\n \"variable\": \"payer.phone_prefix\",\n \"value\": \"11\"\n },\n {\n \"variable\": \"payment_data.transaction_number\",\n \"value\": \"412825250927504\"\n }\n ],\n \"custom_variables\": [\n {\n \"name\": \"Minha variável\",\n \"value\": \"DSAY312HKD312JH\"\n }\n ],\n \"logs\": [\n {\n \"id\": \"F34952A91D364C1AA2C827F62615239D\",\n \"description\": \"Email de Fatura enviado!\",\n \"notes\": \"Fatura enviada com sucesso para: email@iugu.com\",\n \"created_at\": \"02/04, 13:14\"\n },\n {\n \"id\": \"63BD254B355D49F2850667053497DEB5\",\n \"description\": \"Fatura criada com sucesso!\",\n \"notes\": \"Fatura criada!\",\n \"created_at\": \"02/04, 13:14\"\n }\n ],\n \"credit_card_transaction\": null,\n \"account_id\": \"44C5DC6376804D1FA792CBCA382105C1\",\n \"bank_account_branch\": \"0001\",\n \"bank_account_number\": \"2739435-0\",\n \"account_name\": \"Nome da Conta\",\n \"secure_id\": \"ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03\",\n \"secure_url\": \"https://checkout.iugu.com/invoices/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03\",\n \"customer_id\": null,\n \"customer_ref\": null,\n \"customer_name\": null,\n \"user_id\": null,\n \"total\": \"R$ 3,76\",\n \"taxes_paid\": \"R$ 0,00\",\n \"total_paid\": \"R$ 0,00\",\n \"total_overpaid\": \"R$ 0,00\",\n \"total_refunded\": \"R$ 0,00\",\n \"fine_cents\": 0,\n \"commission\": \"R$ 0,00\",\n \"fines_on_occurrence_day\": \"R$ 0,00\",\n \"total_on_occurrence_day\": \"R$ 0,00\",\n \"fines_on_occurrence_day_cents\": 0,\n \"total_on_occurrence_day_cents\": 0,\n \"refunded_cents\": 0,\n \"remaining_captured_cents\": 0,\n \"advance_fee\": null,\n \"estimated_advance_fee\": null,\n \"paid\": \"R$ 0,00\",\n \"original_payment_id\": null,\n \"double_payment_id\": null,\n \"per_day_interest\": false,\n \"per_day_interest_value\": null,\n \"per_day_interest_cents\": 0,\n \"interest\": null,\n \"discount\": \"R$ 0,24\",\n \"duplicated_invoice_id\": null,\n \"bank_slip_extra_due\": 1,\n \"created_at\": \"02/04, 13:14\",\n \"created_at_iso\": \"2025-04-02T13:14:26-03:00\",\n \"authorized_at\": null,\n \"authorized_at_iso\": null,\n \"expired_at\": null,\n \"expired_at_iso\": null,\n \"refunded_at\": null,\n \"refunded_at_iso\": null,\n \"canceled_at\": null,\n \"canceled_at_iso\": null,\n \"protested_at\": null,\n \"protested_at_iso\": null,\n \"chargeback_at\": null,\n \"chargeback_at_iso\": null,\n \"occurrence_date\": null,\n \"refundable\": null,\n \"installments\": null,\n \"transaction_number\": 412825250927504,\n \"payment_method\": null,\n \"financial_return_dates\": null,\n \"bank_slip\": {\n \"digitable_line\": \"40192025089200000000700002008647710390000000376\",\n \"barcode_data\": \"40197103900000003762025092000000000000200864\",\n \"barcode\": \"https://api.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/barcode\",\n \"bank_slip_url\": \"https://boletos.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/bank_slip\",\n \"bank_slip_pdf_url\": \"https://boletos.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/bank_slip.pdf\",\n \"bank_slip_bank\": 401,\n \"bank_slip_status\": \"pending\",\n \"bank_slip_error_code\": null,\n \"bank_slip_error_message\": null,\n \"recipient_cpf_cnpj\": \"42135294870\"\n },\n \"pix\": {\n \"qrcode\": \"https://faturas.iugu.com/qr_code/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03\",\n \"qrcode_text\": \"00020101021226890014br.gov.bcb.pix2567qr.iugu.com/public/payload/v2/cobv/EBB161AAB22849BFA047D5F1DF55AEE952040000530398654043.765802BR5924NOME DA CONTA6009SAO PAULO62070503***630405E6\",\n \"status\": \"qr_code_created\",\n \"payer_cpf_cnpj\": null,\n \"payer_name\": null,\n \"end_to_end_id\": null,\n \"end_to_end_refund_id\": null,\n \"account_number_last_digits\": null\n },\n \"items\": [\n {\n \"id\": \"03B951855B92410890A0EA5742636E96\",\n \"description\": \"Nome do Item\",\n \"price_cents\": 300,\n \"quantity\": 1,\n \"created_at\": \"2025-04-02T13:14:26-03:00\",\n \"updated_at\": \"2025-04-02T13:14:26-03:00\",\n \"price\": \"R$ 3,00\"\n },\n {\n \"id\": \"36E1C5DFFD834DB6A06B67DA76363C51\",\n \"description\": \"Nome do Item 2\",\n \"price_cents\": 100,\n \"quantity\": 1,\n \"created_at\": \"2025-04-02T13:14:26-03:00\",\n \"updated_at\": \"2025-04-02T13:14:26-03:00\",\n \"price\": \"R$ 1,00\"\n }\n ],\n \"early_payment_discounts\": [],\n \"split_rules\": [\n {\n \"id\": \"AB1B22F356464105A3C17BA18A640BA9\",\n \"split_id\": \"3270D0BAB8074BDE98E382340338550C\",\n \"recipient_account_id\": \"E638DCED176240E4A510510C065FB52D\",\n \"cents\": 10,\n \"percent\": 1,\n \"credit_card_cents\": null,\n \"credit_card_percent\": null,\n \"bank_slip_cents\": null,\n \"bank_slip_percent\": null,\n \"pix_cents\": null,\n \"pix_percent\": null,\n \"permit_aggregated\": true,\n \"created_at\": \"2025-04-02T13:14:26-03:00\",\n \"updated_at\": \"2025-04-02T13:14:26-03:00\",\n \"credit_card_1x_cents\": null,\n \"credit_card_2x_cents\": null,\n \"credit_card_3x_cents\": null,\n \"credit_card_4x_cents\": null,\n \"credit_card_5x_cents\": null,\n \"credit_card_6x_cents\": null,\n \"credit_card_7x_cents\": null,\n \"credit_card_8x_cents\": null,\n \"credit_card_9x_cents\": null,\n \"credit_card_10x_cents\": null,\n \"credit_card_11x_cents\": null,\n \"credit_card_12x_cents\": null,\n \"credit_card_1x_percent\": null,\n \"credit_card_2x_percent\": null,\n \"credit_card_3x_percent\": null,\n \"credit_card_4x_percent\": null,\n \"credit_card_5x_percent\": null,\n \"credit_card_6x_percent\": null,\n \"credit_card_7x_percent\": null,\n \"credit_card_8x_percent\": null,\n \"credit_card_9x_percent\": null,\n \"credit_card_10x_percent\": null,\n \"credit_card_11x_percent\": null,\n \"credit_card_12x_percent\": null,\n \"credit_card_13x_cents\": null,\n \"credit_card_14x_cents\": null,\n \"credit_card_15x_cents\": null,\n \"credit_card_16x_cents\": null,\n \"credit_card_17x_cents\": null,\n \"credit_card_18x_cents\": null,\n \"credit_card_13x_percent\": null,\n \"credit_card_14x_percent\": null,\n \"credit_card_15x_percent\": null,\n \"credit_card_16x_percent\": null,\n \"credit_card_17x_percent\": null,\n \"credit_card_18x_percent\": null\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "EBB161AAB22849BFA047D5F1DF55AEE9" }, "due_date": { "type": "string", "example": "2025-04-02" }, "currency": { "type": "string", "example": "BRL" }, "discount_cents": { "type": "integer", "example": 24, "default": 0 }, "email": { "type": "string", "example": "email@iugu.com" }, "items_total_cents": { "type": "integer", "example": 400, "default": 0 }, "notification_url": {}, "return_url": { "type": "string", "example": "https://google.com" }, "status": { "type": "string", "example": "canceled" }, "tax_cents": {}, "total_cents": { "type": "integer", "example": 376, "default": 0 }, "total_paid_cents": { "type": "integer", "example": 0, "default": 0 }, "taxes_paid_cents": {}, "paid_at": {}, "paid_cents": {}, "cc_emails": {}, "financial_return_date": {}, "payable_with": { "type": "string", "example": "all" }, "overpaid_cents": {}, "ignore_due_email": {}, "ignore_canceled_email": {}, "advance_fee_cents": {}, "commission_cents": {}, "early_payment_discount": { "type": "boolean", "example": false, "default": true }, "order_id": {}, "updated_at": { "type": "string", "example": "2025-04-02T13:14:27-03:00" }, "credit_card_brand": {}, "credit_card_bin": {}, "credit_card_last_4": {}, "credit_card_captured_at": {}, "credit_card_tid": {}, "external_reference": {}, "max_installments_value": {}, "payer_name": { "type": "string", "example": "John" }, "payer_email": {}, "payer_cpf_cnpj": { "type": "string", "example": "11343675030" }, "payer_phone": { "type": "string", "example": "971113024" }, "payer_phone_prefix": { "type": "string", "example": "11" }, "payer_address_zip_code": { "type": "string", "example": "13056-344" }, "payer_address_street": { "type": "string", "example": "Rua Antônio Nunes" }, "payer_address_district": { "type": "string", "example": "Dic I (Conjunto Habitacional Monsenhor Luiz Fernando Abreu)" }, "payer_address_city": { "type": "string", "example": "Campinas" }, "payer_address_state": { "type": "string", "example": "SP" }, "payer_address_number": { "type": "string", "example": "21" }, "payer_address_complement": { "type": "string", "example": "AP1702" }, "payer_address_country": { "type": "string", "example": "Brasil" }, "late_payment_fine": { "type": "integer", "example": 0, "default": 0 }, "late_payment_fine_cents": {}, "split_id": { "type": "string", "example": "3270D0BAB8074BDE98E382340338550C" }, "external_payment_id": {}, "external_payment_description": {}, "payment_booklet_id": {}, "subscription_id": {}, "variables": { "type": "array", "items": { "type": "object", "properties": { "variable": { "type": "string", "example": "barcode_v1" }, "value": { "type": "string", "example": "40197103900000003762025092000000000000200864" } } } }, "custom_variables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Minha variável" }, "value": { "type": "string", "example": "DSAY312HKD312JH" } } } }, "logs": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "F34952A91D364C1AA2C827F62615239D" }, "description": { "type": "string", "example": "Email de Fatura enviado!" }, "notes": { "type": "string", "example": "Fatura enviada com sucesso para: email@iugu.com" }, "created_at": { "type": "string", "example": "02/04, 13:14" } } } }, "credit_card_transaction": {}, "account_id": { "type": "string", "example": "44C5DC6376804D1FA792CBCA382105C1" }, "bank_account_branch": { "type": "string", "example": "0001" }, "bank_account_number": { "type": "string", "example": "2739435-0" }, "account_name": { "type": "string", "example": "Nome da Conta" }, "secure_id": { "type": "string", "example": "ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03" }, "secure_url": { "type": "string", "example": "https://checkout.iugu.com/invoices/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03" }, "customer_id": {}, "customer_ref": {}, "customer_name": {}, "user_id": {}, "total": { "type": "string", "example": "R$ 3,76" }, "taxes_paid": { "type": "string", "example": "R$ 0,00" }, "total_paid": { "type": "string", "example": "R$ 0,00" }, "total_overpaid": { "type": "string", "example": "R$ 0,00" }, "total_refunded": { "type": "string", "example": "R$ 0,00" }, "fine_cents": { "type": "integer", "example": 0, "default": 0 }, "commission": { "type": "string", "example": "R$ 0,00" }, "fines_on_occurrence_day": { "type": "string", "example": "R$ 0,00" }, "total_on_occurrence_day": { "type": "string", "example": "R$ 0,00" }, "fines_on_occurrence_day_cents": { "type": "integer", "example": 0, "default": 0 }, "total_on_occurrence_day_cents": { "type": "integer", "example": 0, "default": 0 }, "refunded_cents": { "type": "integer", "example": 0, "default": 0 }, "remaining_captured_cents": { "type": "integer", "example": 0, "default": 0 }, "advance_fee": {}, "estimated_advance_fee": {}, "paid": { "type": "string", "example": "R$ 0,00" }, "original_payment_id": {}, "double_payment_id": {}, "per_day_interest": { "type": "boolean", "example": false, "default": true }, "per_day_interest_value": {}, "per_day_interest_cents": { "type": "integer", "example": 0, "default": 0 }, "interest": {}, "discount": { "type": "string", "example": "R$ 0,24" }, "duplicated_invoice_id": {}, "bank_slip_extra_due": { "type": "integer", "example": 1, "default": 0 }, "created_at": { "type": "string", "example": "02/04, 13:14" }, "created_at_iso": { "type": "string", "example": "2025-04-02T13:14:26-03:00" }, "authorized_at": {}, "authorized_at_iso": {}, "expired_at": {}, "expired_at_iso": {}, "refunded_at": {}, "refunded_at_iso": {}, "canceled_at": {}, "canceled_at_iso": {}, "protested_at": {}, "protested_at_iso": {}, "chargeback_at": {}, "chargeback_at_iso": {}, "occurrence_date": {}, "refundable": {}, "installments": {}, "transaction_number": { "type": "integer", "example": 412825250927504, "default": 0 }, "payment_method": {}, "financial_return_dates": {}, "bank_slip": { "type": "object", "properties": { "digitable_line": { "type": "string", "example": "40192025089200000000700002008647710390000000376" }, "barcode_data": { "type": "string", "example": "40197103900000003762025092000000000000200864" }, "barcode": { "type": "string", "example": "https://api.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/barcode" }, "bank_slip_url": { "type": "string", "example": "https://boletos.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/bank_slip" }, "bank_slip_pdf_url": { "type": "string", "example": "https://boletos.iugu.com/v1/public/invoice/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03/bank_slip.pdf" }, "bank_slip_bank": { "type": "integer", "example": 401, "default": 0 }, "bank_slip_status": { "type": "string", "example": "pending" }, "bank_slip_error_code": {}, "bank_slip_error_message": {}, "recipient_cpf_cnpj": { "type": "string", "example": "42135294870" } } }, "pix": { "type": "object", "properties": { "qrcode": { "type": "string", "example": "https://faturas.iugu.com/qr_code/ebb161aa-b228-49bf-a047-d5f1df55aee9-cb03" }, "qrcode_text": { "type": "string", "example": "00020101021226890014br.gov.bcb.pix2567qr.iugu.com/public/payload/v2/cobv/EBB161AAB22849BFA047D5F1DF55AEE952040000530398654043.765802BR5924NOME DA CONTA6009SAO PAULO62070503***630405E6" }, "status": { "type": "string", "example": "qr_code_created" }, "payer_cpf_cnpj": {}, "payer_name": {}, "end_to_end_id": {}, "end_to_end_refund_id": {}, "account_number_last_digits": {} } }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "03B951855B92410890A0EA5742636E96" }, "description": { "type": "string", "example": "Nome do Item" }, "price_cents": { "type": "integer", "example": 300, "default": 0 }, "quantity": { "type": "integer", "example": 1, "default": 0 }, "created_at": { "type": "string", "example": "2025-04-02T13:14:26-03:00" }, "updated_at": { "type": "string", "example": "2025-04-02T13:14:26-03:00" }, "price": { "type": "string", "example": "R$ 3,00" } } } }, "early_payment_discounts": { "type": "array", "items": { "type": "object", "properties": {} } }, "split_rules": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "AB1B22F356464105A3C17BA18A640BA9" }, "split_id": { "type": "string", "example": "3270D0BAB8074BDE98E382340338550C" }, "recipient_account_id": { "type": "string", "example": "E638DCED176240E4A510510C065FB52D" }, "cents": { "type": "integer", "example": 10, "default": 0 }, "percent": { "type": "integer", "example": 1, "default": 0 }, "credit_card_cents": {}, "credit_card_percent": {}, "bank_slip_cents": {}, "bank_slip_percent": {}, "pix_cents": {}, "pix_percent": {}, "permit_aggregated": { "type": "boolean", "example": true, "default": true }, "created_at": { "type": "string", "example": "2025-04-02T13:14:26-03:00" }, "updated_at": { "type": "string", "example": "2025-04-02T13:14:26-03:00" }, "credit_card_1x_cents": {}, "credit_card_2x_cents": {}, "credit_card_3x_cents": {}, "credit_card_4x_cents": {}, "credit_card_5x_cents": {}, "credit_card_6x_cents": {}, "credit_card_7x_cents": {}, "credit_card_8x_cents": {}, "credit_card_9x_cents": {}, "credit_card_10x_cents": {}, "credit_card_11x_cents": {}, "credit_card_12x_cents": {}, "credit_card_1x_percent": {}, "credit_card_2x_percent": {}, "credit_card_3x_percent": {}, "credit_card_4x_percent": {}, "credit_card_5x_percent": {}, "credit_card_6x_percent": {}, "credit_card_7x_percent": {}, "credit_card_8x_percent": {}, "credit_card_9x_percent": {}, "credit_card_10x_percent": {}, "credit_card_11x_percent": {}, "credit_card_12x_percent": {}, "credit_card_13x_cents": {}, "credit_card_14x_cents": {}, "credit_card_15x_cents": {}, "credit_card_16x_cents": {}, "credit_card_17x_cents": {}, "credit_card_18x_cents": {}, "credit_card_13x_percent": {}, "credit_card_14x_percent": {}, "credit_card_15x_percent": {}, "credit_card_16x_percent": {}, "credit_card_17x_percent": {}, "credit_card_18x_percent": {} } } } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Invoice Not Found": { "value": "{\n \"errors\": \"Invoice Not Found\"\n}" } }, "schema": { "type": "object", "properties": { "errors": { "type": "string", "example": "Invoice Not Found" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```