---
title: "Cancelar uma fatura"
method: DELETE
path: "/recurrence/subscriptions/{subscription_id}/invoices/{invoice_id}"
tags: ["Faturas"]
---

# Cancelar uma fatura

`DELETE /recurrence/subscriptions/{subscription_id}/invoices/{invoice_id}`

## Path parameters

- `subscription_id` string, required
- `invoice_id` string, required

## Response `200`

Assinatura criada com sucesso

- InvoiceCreatedDTO
  - `invoice_id` string, required — Id da fatura.
  - `installment` integer, required
  - `amount` string, required — Valor total da fatura
  - `status` string — Status do item
  - `payment_method` string, required — Meio de pagamento. Valores possíveis: credit_card, boleto, voucher e pix.
  - `due_at` string, date-time, required — Data de cobrança da fatura.
  - `created_at` string, date-time, required — Data de criação da fatura.
  - `items` PlanItemDTOOutput[], required — Itens do plano.
    - `product_id` string, required — Id do produto.
    - `amount` string, required — Valor unitário do produto
    - `description` string — Descrição do produto
    - `type` string — Tipo do produto
    - `status` string — Status do item
    - `metadata` object — Dados adicionais do produto
  - `customer` ZpyEnterpriseResourcesDomainPaymentOrderModelValueObjectsOrderValueObjectsCustomer
    - `name` string, required
    - `email` string, nullable
    - `phone` string, nullable
    - `document` string, nullable
    - `birthdate` string, date-time, nullable
    - `address` CustomerAddress
      - `zip_code` string, required
      - `line_1` string, required
      - `line_2` string, nullable, required
      - `state` string, required
      - `city` string, required
      - `metadata` object, nullable
    - `external_id` string, nullable
    - `metadata` object, nullable
  - `charge` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosChargeResponseDTO
    - `charge_id` string, required
    - `code` string, nullable
    - `gateway_id` string, nullable
    - `amount` number, required
    - `status` string, required
    - `payment_method` string, nullable
    - `paid_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `last_transaction` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosLastTransactionResponseDTO
      - `transaction_id` string, required
      - `transaction_type` string, required
      - `amount` number, required
      - `status` string, nullable
      - `success` boolean, nullable
      - `installments` integer, nullable
      - `operation_type` string, nullable
      - `card` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosCardResponseDTO
        - `last_four_digits` union, required
          - string
          - integer
        - `brand` string, nullable, required
        - `holder_name` string, nullable, required
        - `exp_month` integer, nullable, required
        - `exp_year` integer, nullable, required
        - `status` string, nullable
        - `billing_address` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosAddressResponseDTO, required
          - `zip_code` string, required
          - `state` string, required
          - `city` string, required
          - `line_1` string, nullable
          - `line_2` string, nullable
          - `metadata` object
        - `type` string, nullable
        - `created_at` string, date-time
        - `updated_at` string, date-time
      - `bank_slip` BankSlipResponseDTO
        - `line` string, nullable
        - `barcode` string, nullable
        - `url` string, nullable
        - `pdf` string, nullable
        - `qr_code` string, nullable
        - `nosso_numero` string, nullable
        - `document_number` string, nullable
        - `instructions` string, nullable
        - `due_at` string, date-time, nullable
      - `pix` PixResponseDTO
        - `qr_code` string, nullable
        - `qr_code_url` string, nullable
        - `additional_information` object, nullable
      - `gateway_id` string, nullable
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `gateway_response` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosGatewayResponseDTO
        - `message` string, nullable
        - `code` string, nullable
      - `antifraud_response` ZpyEnterpriseResourcesDomainPaymentOrderDtosOrderResponseDtosAntifraudResponseDTO
        - `status` string, nullable
        - `return_code` string, nullable
        - `return_message` string, nullable
        - `score` integer, nullable
  - `metadata` object, nullable — Dados adicionais da fatura.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usezapay/apis/zapi.md) · [All operations](https://skmtc.net/usezapay/apis/zapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usezapay/zapi/revisions/50c96157fff4/schema)