> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refy.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Cobranca

> Como cobranca e creditos funcionam na API do Refy.

# Cobranca

A cobranca no Refy e vinculada a uma area de trabalho.

## O que você consegue consultar

* saldo de créditos
* carteira
* transações
* assinatura
* perfil de cobranca
* formas de pagamento
* faturas
* recarga automatica

## O que você consegue completar

Depois de criar um checkout, o fluxo é fechado por:

* `POST /v1/billing/complete`

## O que você consegue criar

* forma de pagamento
* politica de recarga automatica
* checkout de plano
* checkout de pacote de creditos

## Rotas principais

* `GET /v1/workspaces/{workspaceId}/billing/credits`
* `GET /v1/workspaces/{workspaceId}/billing/wallet`
* `GET /v1/workspaces/{workspaceId}/billing/subscription`
* `GET /v1/workspaces/{workspaceId}/billing/payment-methods`
* `POST /v1/workspaces/{workspaceId}/billing/payment-methods`
* `POST /v1/workspaces/{workspaceId}/billing/plan-checkout`
* `POST /v1/workspaces/{workspaceId}/billing/credit-packs`
* `POST /v1/billing/complete`

## Observação

Para portal público, essa área precisa ser muito clara porque mexe com cobrança. O OpenAPI deve continuar sendo a base, mas páginas conceituais ajudam a evitar erro de integração.

## Recomendação de integração

* trate cobranca como superficie separada do fluxo de analise
* so peca checkout quando o usuario ja tiver contexto claro da area de trabalho
* deixe o cliente distinguir compra de créditos e mudança de plano