> ## 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. # Pagar fatura no checkout > Cria a cobrança de uma fatura aberta no meio escolhido pelo pagador (`pix`, `boleto`, `card` ou `crypto`). A resposta traz o que o pagador precisa para concluir, como o QR Code do Pix. A confirmação chega depois: consulte o status do pagamento ou espere o webhook `payment.confirmed`. ## OpenAPI ````yaml /api-reference/openapi.pt-BR.json post /pay/{slug}/invoices/{invoiceID}/charge 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}/charge: post: tags: - Checkout summary: Pagar fatura no checkout description: > Cria a cobrança de uma fatura aberta no meio escolhido pelo pagador (`pix`, `boleto`, `card` ou `crypto`). A resposta traz o que o pagador precisa para concluir, como o QR Code do Pix. A confirmação chega depois: consulte o status do pagamento ou espere o webhook `payment.confirmed`. operationId: chargeCheckoutInvoice 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. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CheckoutChargeRequest' responses: '201': content: application/json: schema: $ref: '#/components/schemas/Payment' description: A cobrança criada. '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' '409': content: application/json: schema: $ref: '#/components/schemas/ConflictError' description: > A fatura não está aberta (`invoice_not_open`), já existe uma cobrança em andamento nela (`charge_in_progress`), a cobrança anterior já está sendo processada e não pode ser trocada por outro meio (`charge_already_processing` — espere ela terminar), ou a configuração de cartão da conta está incompleta (`client_key_missing`). '422': content: application/json: schema: $ref: '#/components/schemas/ValidationError' description: > Algo que dá para corrigir. Além de `validation_failed`: `customer_tax_id_required` (Pix e boleto exigem CPF/CNPJ do pagador) e `amount_below_minimum` (em reais, uma cobrança abaixo de R$ 5,00 pode ser recusada; o mínimo que vale para esta cobrança vem em `errors[]`, no campo `amount`; um cupom com desconto alto pode causar isso). '429': $ref: '#/components/responses/RateLimited' '502': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Não foi possível criar a cobrança agora, ou liberar a tentativa anterior para trocar de meio. Nada foi cobrado; tente de novo. '503': $ref: '#/components/responses/ServiceUnavailable' security: [] components: schemas: CheckoutChargeRequest: type: object required: - method properties: method: type: string enum: - pix - boleto - card - crypto description: Meio de pagamento. card: $ref: '#/components/schemas/CheckoutCardInput' description: >- Dados do cartão. Obrigatório quando `method` é `card` num checkout embutido. saveInstrument: type: boolean description: >- O pagador escolheu salvar o cartão para cobranças automáticas futuras. Exige `consentTextVersion`; sem ele, responde 422. consentTextVersion: type: string description: >- A versão do texto de autorização que o pagador viu: repita `CheckoutSession.mandate.version`. Obrigatório com `saveInstrument`. surface: type: string enum: - hosted - embed default: hosted description: >- Qual checkout da Infi o pagador está usando. Define para onde o navegador volta depois de uma verificação do banco. Use `embed` num checkout embutido (iframe); sem o campo, vale `hosted`, e o pagador sai do iframe para a página completa. description: >- O meio escolhido pelo pagador. `method` ausente ou fora da lista responde 422. Payment: type: object properties: id: type: string format: uuid invoiceId: type: string format: uuid provider: type: string description: Processador por onde a cobrança passou. Em sandbox, `sandbox`. providerId: type: - string - 'null' description: Referência da cobrança no processador, útil para suporte. method: type: string enum: - pix - boleto - card - crypto amount: type: string description: Valor cobrado, em texto decimal. currency: type: string status: type: string enum: - pending - confirmed - failed - refunded - charged_back description: >- `pending` aguarda pagamento; `confirmed` foi pago; `failed` não foi pago (veja `failureCode`); `refunded` foi reembolsado por inteiro; `charged_back` foi contestado pelo comprador no banco. refundedAmount: type: string description: >- Total já reembolsado, em texto decimal. Ausente quando nada foi reembolsado. Um reembolso parcial mantém o `status` em `confirmed`; só o reembolso do valor inteiro muda para `refunded`. Use este campo, e não o `status`, para saber quanto voltou. failureCode: type: - string - 'null' enum: - insufficient_funds - do_not_honor - card_declined - authentication_required - card_expired - card_stolen - card_invalid - mandate_revoked - mandate_refused - brand_changed - provider_error - provider_timeout - superseded - null description: >- Por que a cobrança falhou. `superseded` não é recusa: o comprador trocou de meio de pagamento para pagar a mesma fatura. Nulo quando o pagamento não falhou ou quando o motivo não foi registrado. Novos códigos podem surgir; trate um valor desconhecido como falha genérica. failedAt: type: - string - 'null' format: date-time description: Quando a cobrança passou para `failed`. createdAt: type: string format: date-time payer: type: - object - 'null' properties: id: type: string format: uuid name: type: - string - 'null' email: type: - string - 'null' description: >- Quem pagou. Em fatura avulsa, `id` é o ID do cliente; em fatura de assinatura, é o ID da inscrição do cliente no produto. Vem só em `GET /billing/payments` e `GET /billing/payments/{paymentID}`, e é nulo quando a fatura não identifica o cliente. invoiceUrl: type: string description: >- Página de pagamento hospedada. Vem só na resposta da criação da cobrança. chargeToken: type: string description: >- Token de uso único do widget de pagamento cripto. Vem só na resposta de uma cobrança cripto. network: type: string enum: - main - test description: 'Ambiente do widget cripto desta cobrança: `main` (real) ou `test`.' settlementAsset: type: string enum: - USDC description: Ativo em que a cobrança cripto é liquidada. settlementNetwork: type: string enum: - base - solana description: Rede em que a cobrança cripto é liquidada. pixPayload: type: string description: >- Código Pix copia e cola. Gere o QR a partir dele. Continua disponível nas consultas seguintes do pagamento. pixQrImage: type: string description: >- O QR do Pix em PNG, codificado em base64 (sem o prefixo `data:`), para quem prefere não gerar o QR. providerPixPayload: type: string description: >- Só em sandbox: o código Pix que o processador de teste gerou, para inspeção. Não é pagável. Em sandbox, `pixPayload` traz o link de confirmação de teste. sandboxConfirmUrl: type: string description: >- Só em sandbox: página que marca esta cobrança como paga, sem pagar de verdade. Decida pela presença deste campo, não pelo formato de `pixPayload`. Para exibir, não é preciso: `pixPayload` vira QR nos dois ambientes. pixExpiresAt: type: - string - 'null' format: date-time description: Quando o código Pix expira (só cobranças Pix). clientSecret: type: string description: >- Segredo temporário para confirmar a cobrança de cartão no navegador. Vem só na resposta da criação da cobrança. publishableKey: type: string description: >- Chave pública que acompanha `clientSecret`. Vem só na resposta da criação da cobrança. nextAction: $ref: '#/components/schemas/PaymentNextAction' description: >- Dados para concluir uma cobrança de cartão no navegador. Vem só na resposta da criação da cobrança. switchable: type: boolean description: >- Se esta cobrança ainda pode ser abandonada para pagar a mesma fatura de outro jeito: `true` enquanto está `pending`, `false` depois de paga ou falhada. Vem só na resposta da criação da cobrança; trate ausência como `false`. description: >- Uma tentativa de cobrança contra uma fatura. Uma fatura pode ter vários pagamentos. ConflictError: type: object required: - message - error_code - tracer_id - resource - metadata properties: message: type: string description: Explicação para pessoas. error_code: $ref: '#/components/schemas/ErrorCode' description: Código estável do erro. Use este campo para decidir o que fazer. tracer_id: type: string description: Identificador da requisição. Envie ao suporte. resource: type: string description: O tipo de recurso em conflito. Texto vazio quando não se aplica. metadata: type: - object - 'null' additionalProperties: type: string description: Detalhes do conflito, em pares chave-valor. `null` quando não há. description: >- Corpo de um erro 409: o recurso está num estado que não permite a operação. ValidationError: type: object required: - message - error_code - tracer_id - errors properties: message: type: string error_code: $ref: '#/components/schemas/ErrorCode' tracer_id: type: string errors: type: array items: type: object required: - field - value - constraint - description properties: field: type: string value: type: string constraint: type: string description: type: string description: >- Detalhe por campo (`field`, `description`). Sempre presente num `422`; pode vir vazio. description: >- Corpo de um `422`. Mesmo formato de `Error`, mais `errors[]` com o detalhe por campo. É ali que está a frase que diz o que corrigir (por exemplo, "product has no published version"). 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`. CheckoutCardInput: type: object required: - number - holderName - expiryMonth - expiryYear - ccv - holderEmail - holderCpfCnpj - holderPostalCode - holderAddressNumber properties: number: type: string holderName: type: string expiryMonth: type: string example: '12' expiryYear: type: string example: '2030' ccv: type: string description: Código de segurança do cartão. holderEmail: type: string format: email holderCpfCnpj: type: string description: CPF ou CNPJ do titular do cartão. holderPostalCode: type: string description: CEP do titular. holderAddressNumber: type: string description: Número do endereço do titular. holderPhone: type: string description: >- Dados do cartão e do titular para cobrar por cartão num checkout embutido. Enviados por conexão segura; número e código de segurança nunca são armazenados pela Infi. Todos os campos são obrigatórios. PaymentNextAction: oneOf: - $ref: '#/components/schemas/CardSessionAction' - $ref: '#/components/schemas/CardPaymentAction' discriminator: propertyName: type mapping: adyen_session: $ref: '#/components/schemas/CardSessionAction' stripe_payment_intent: $ref: '#/components/schemas/CardPaymentAction' description: >- Dados temporários para o navegador concluir a cobrança. Decida pelo campo `type`. Use só na mesma sessão; não reaproveite nem aceite esses valores de volta do navegador. 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 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. 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 CardSessionAction: type: object additionalProperties: false required: - type - session - clientKey - environment - countryCode - locale - amount properties: type: type: string const: adyen_session session: type: object additionalProperties: false required: - id - sessionData properties: id: type: string sessionData: type: string description: >- Sessão de checkout a abrir no navegador. Não guarde nem registre em log. clientKey: type: string description: Chave pública, segura para o navegador. environment: type: string enum: - live - live-us - live-au - live-nea - live-in description: Ambiente em que o formulário deve ser carregado. countryCode: type: string const: BR locale: type: string const: pt-BR amount: $ref: '#/components/schemas/ClientActionAmount' description: Valor da cobrança. description: Sessão de pagamento para o formulário de cartão no navegador. CardPaymentAction: type: object additionalProperties: false required: - type - clientSecret - publishableKey properties: type: type: string const: stripe_payment_intent clientSecret: type: string description: Segredo temporário para confirmar a cobrança no navegador. publishableKey: type: string description: Chave pública, segura para o navegador. description: Dados para confirmar a cobrança de cartão no navegador. ClientActionAmount: type: object additionalProperties: false required: - value - currency properties: value: type: integer format: int64 minimum: 0 description: Valor na menor unidade da moeda (centavos, no caso do real). currency: type: string example: BRL 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. ServiceUnavailable: content: application/json: schema: $ref: '#/components/schemas/Error' description: Indisponível no momento. Tente de novo em instantes. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave secreta da conta: `Authorization: Bearer sk_test_…` ou `sk_live_…`. Use só no servidor. ````