Retorna uma fatura específica através do ID.

A fatura totaliza, em valores financeiros, mercadorias ou serviços que serão cobrados do cliente final. Faturas podem ser classificadas em dois tipos:

  1. Faturas provenientes de assinaturas: São as faturas geradas a partir de assinaturas e seus respectivos períodos.
  2. Faturas avulsas: Faturas que não possuem qualquer relação com uma assinatura.

Faturas provenientes de assinaturas

Podem ser geradas de duas formas diferentes:

  1. Automaticamente no dia programado para cobrança através do atributo billing_at do período (apenas se este cumprir com os requisitos de faturamento automático).
  2. Manualmente através do painel de administração ou pelo método da API POST /periods/{id}/bill.

Aprovação de faturas

Ao menos que seja especificado nas configurações da plataforma, toda fatura é gerada com o status "Aguardando aprovação" (review). Este status serve para validar os valores que serão enviados e cobrados do cliente final. A fatura será cobrada somente após a aprovação, que pode ser feita manualmente através do painel de administração ou do método da API POST /bills/{id}/approve.

Itens da fatura

Uma fatura é composta de vários itens representados no array bill_items. Cada item possui um valor e um produto associado. A soma de todos os itens é igual ao total da fatura. A única exceção para esta regra é no caso da aplicação de movimentos adicionais de crédito ou débito.

Descontos

Um desconto será representado por um bill_item com amount negativo e um objeto discount associado. Apenas faturas de assinaturas possuem descontos. Faturas avulsas devem ser geradas com seu valor final.

Cobranças

O ato da aprovação da fatura, seja ele automático ou manual, irá gerar um objeto do tipo cobrança (charge). Este objeto é a representação da cobrança enviada ao cliente e controla, entre outras coisas, vencimento, notificações automáticas e número de retentativas. Normalmente uma fatura irá conter uma única cobrança, porém a plataforma suporta múltiplas cobranças para uma mesma fatura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

ID da fatura que deverá ser retornada.

Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json