> ## Documentation Index > Fetch the complete documentation index at: https://docs.beinfi.com/llms.txt > Use this file to discover all available pages before exploring further. # Ler fatura no checkout > Devolve o que a página de checkout precisa para mostrar uma fatura: dados da sua conta, a fatura e os meios de pagamento disponíveis. Não leva chave; roda no navegador de quem paga. ## OpenAPI ````yaml /api-reference/openapi.pt-BR.json get /pay/{slug}/invoices/{invoiceID} openapi: 3.1.0 info: title: Infi API version: 0.0.1 description: > A API REST do Infi: catálogo, clientes, medição de uso, assinaturas, faturas, pagamentos e checkout. **Autenticação.** Envie a chave secreta em `Authorization: Bearer sk_test_…` (sandbox) ou `sk_live_…` (produção). O prefixo da chave decide o ambiente. As rotas de checkout (`/pay/*`) e `/public/*` não levam chave: rodam no navegador de quem paga. **Idempotência.** Toda requisição que altera dados exige o header `Idempotency-Key`. Uma repetição com a mesma chave devolve a resposta original em vez de executar de novo. **Valores.** Dinheiro e quantidades trafegam como texto decimal (`"150.00"`, `"0.0001"`), nunca como número de ponto flutuante. **Erros.** O corpo traz `error_code` (estável, use para decidir), `message` (para pessoas) e `tracer_id` (envie ao suporte). Erros de limite de requisições e de idempotência vêm aninhados em `error`, com `code` e `request_id`. servers: - url: https://api-sandbox.beinfi.com description: Sandbox - url: https://api.beinfi.com description: Produção security: - bearerAuth: [] tags: - name: Catálogo - name: Clientes - name: Medição de uso - name: Assinaturas - name: Faturas - name: Pagamentos - name: Checkout - name: Cupons - name: Cobrança - name: Conta - name: Webhooks - name: Conta de teste - name: Rail - name: Lojas paths: /pay/{slug}/invoices/{invoiceID}: get: tags: - Checkout summary: Ler fatura no checkout description: > Devolve o que a página de checkout precisa para mostrar uma fatura: dados da sua conta, a fatura e os meios de pagamento disponíveis. Não leva chave; roda no navegador de quem paga. operationId: getCheckoutSession parameters: - name: slug in: path required: true schema: type: string description: O identificador público da sua conta, o mesmo das URLs de checkout. - name: invoiceID in: path required: true schema: type: string format: uuid description: ID da fatura. responses: '200': content: application/json: schema: $ref: '#/components/schemas/CheckoutSession' description: A fatura e as opções de pagamento. '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' security: [] components: schemas: CheckoutSession: type: object required: - merchant - invoice - testMode - paymentOptions - cardEnabled - cryptoEnabled properties: merchant: type: object required: - slug - name properties: slug: type: string name: type: string logoUrl: type: string format: uri description: Nome e aparência da sua conta, como o pagador vê. invoice: $ref: '#/components/schemas/Invoice' testMode: type: boolean description: '`true` quando a fatura é do sandbox: nenhum dinheiro real se move.' paymentOptions: type: array items: $ref: '#/components/schemas/PublicPaymentOption' description: Os meios de pagamento disponíveis para esta fatura. cardEnabled: type: boolean description: >- Se cartão está disponível. Derivado de `paymentOptions`; sempre presente. cryptoEnabled: type: boolean description: Se pagamento em cripto está disponível neste checkout. paymentMethod: type: string enum: - pix - boleto - card - crypto description: Meio do pagamento confirmado. Só aparece depois que a fatura é paga. mandate: type: object required: - version - text properties: version: type: string text: type: string description: >- Autorização para salvar o cartão, que o pagador precisa aceitar. Só aparece quando há cartão e a fatura está aberta. Envie `version` como `consentTextVersion` ao cobrar com `saveInstrument`. description: O que a página de checkout recebe para mostrar e cobrar uma fatura. Invoice: type: object properties: id: type: string format: uuid customerId: type: - string - 'null' format: uuid description: >- Id da inscrição do cliente no produto. Preenchido em faturas de produto, uso ou assinatura. payerId: type: - string - 'null' format: uuid description: Id do cliente que paga. Preenchido em faturas avulsas. subscriptionId: type: - string - 'null' format: uuid description: Assinatura que gerou a fatura invoiceNumber: type: - string - 'null' description: Número sequencial da fatura status: type: string enum: - draft - open - paid - void - uncollectible description: >- `draft` (em montagem), `open` (emitida, aguardando pagamento), `paid`, `void` (cancelada) ou `uncollectible` (dada como perdida). currency: type: string description: Moeda, em código ISO 4217 (`BRL`). subtotal: type: string description: Soma dos itens antes de impostos e descontos. tax: type: string description: Impostos da fatura. total: type: string description: Valor final da fatura. amountDue: type: string description: Quanto ainda falta pagar. periodStart: type: - string - 'null' format: date-time description: Início do período cobrado periodEnd: type: - string - 'null' format: date-time description: Fim do período cobrado dueDate: type: - string - 'null' format: date-time description: Data de vencimento. finalizedAt: type: - string - 'null' format: date-time description: Quando a fatura foi emitida. paidAt: type: - string - 'null' format: date-time description: Quando a fatura foi paga. successUrl: type: - string - 'null' description: Para onde o checkout leva o comprador depois do pagamento. cancelUrl: type: - string - 'null' description: Para onde o checkout leva o comprador se ele desistir. createdAt: type: string format: date-time lineItems: type: array items: $ref: '#/components/schemas/InvoiceLineItem' description: >- O que um cliente deve: itens, totais e status. Status: `draft` → `open` → `paid`, ou `void` / `uncollectible`. PublicPaymentOption: oneOf: - $ref: '#/components/schemas/PublicPixPaymentOption' - $ref: '#/components/schemas/PublicCardPaymentOption' description: >- Um meio de pagamento que o checkout pode oferecer. É uma indicação: a disponibilidade é conferida de novo na cobrança. Error: type: object required: - message - error_code - tracer_id properties: message: type: string description: Frase legível para pessoas. error_code: $ref: '#/components/schemas/ErrorCode' description: Código estável do erro. Use-o para decidir o que fazer. tracer_id: type: string description: Identificador da requisição. Informe-o ao falar com o suporte. description: >- O corpo de erro padrão. É plano (sem o envelope `error`) e o identificador de rastreio é `tracer_id`. NotFoundError: type: object required: - message - error_code - tracer_id - resource properties: message: type: string error_code: $ref: '#/components/schemas/ErrorCode' tracer_id: type: string resource: type: string RequestError: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string request_id: type: string InvoiceLineItem: type: object properties: id: type: string format: uuid type: type: string enum: - usage - recurring - proration - credit - adjustment - commitment - manual description: >- `usage` (uso medido), `recurring` (mensalidade), `proration` (ajuste proporcional por troca no meio do período), `credit` (crédito), `adjustment` (uso que chegou depois de um período já faturado), `commitment` (diferença até o compromisso mínimo) ou `manual` (linha livre). meterId: type: - string - 'null' format: uuid description: Meter de onde veio o uso priceId: type: - string - 'null' format: uuid description: Preço aplicado a esta linha. description: type: string quantity: type: string description: Quantidade cobrada unitPrice: type: - string - 'null' description: Preço por unidade amount: type: string description: Total da linha proration: type: boolean description: '`true` quando a linha é um valor proporcional.' description: Uma linha da fatura. PublicPixPaymentOption: type: object additionalProperties: false required: - method - flow properties: method: type: string const: pix flow: type: string const: pix description: Como o pagamento é concluído no navegador. PublicCardPaymentOption: type: object additionalProperties: false required: - method - provider - flow - supportsSavedInstrument properties: method: type: string const: card provider: type: string enum: - adyen - stripe flow: type: string enum: - adyen_session - stripe_payment_intent description: Como o pagamento é concluído no navegador. supportsSavedInstrument: type: boolean description: Se o pagador pode salvar o cartão para cobranças futuras. ErrorCode: type: string examples: - internal_error - validation_failed - bad_request - unauthorized - forbidden - not_found - conflict - rate_limited description: >- Código estável do erro. A lista não é fechada: além dos códigos genéricos, cada área tem os seus (`coupon_expired`, `insufficient_balance`, `version_not_draft`, `idempotency_key_reused`…). Um código que você não conhece deve ser tratado pelo status HTTP, mostrando `message`; não falhe ao ler a resposta. responses: BadRequest: content: application/json: schema: $ref: '#/components/schemas/Error' description: Requisição malformada. NotFound: content: application/json: schema: $ref: '#/components/schemas/NotFoundError' description: Recurso não encontrado. RateLimited: headers: Retry-After: schema: type: integer content: application/json: schema: $ref: '#/components/schemas/RequestError' description: >- Limite de requisições excedido. `Retry-After` diz quantos segundos esperar. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave secreta da conta: `Authorization: Bearer sk_test_…` ou `sk_live_…`. Use só no servidor. ````