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

# Qual API usar

> A Ephra tem duas APIs no mesmo endereço e com o mesmo token: a de cobranças e a do vendedor. Veja qual resolve o seu caso.

As duas APIs ficam em `https://api.ephra.io`, aceitam o **mesmo token** de `POST /auth` e devolvem valores em centavos. O que muda é o que cada uma faz.

> [card] API de cobranças
>
> Você cobra o cliente direto do seu sistema: Pix, cartão e assinatura, sem passar pelo checkout da Ephra. Também lista e consulta as vendas.

> [card] API do vendedor
>
> Você opera a conta: produtos, ofertas, checkouts, afiliados, reembolsos, área de membros, financeiro e webhooks. É a mesma coisa que o painel faz.

## Pelo que você quer fazer

| Você quer | Use |
| - | - |
| Gerar Pix ou cobrar cartão do seu próprio checkout | API de cobranças: `POST /v1/pix/in/qrcode`, `POST /v1/card` |
| Criar assinatura cobrada no cartão | API de cobranças: `POST /v1/subscriptions` |
| Listar e consultar vendas | API de cobranças: `GET /v1/transactions` |
| Exportar vendas, reembolsar uma venda | API do vendedor: `POST /v1/transactions/export`, `POST /v1/transactions/{id}/refund` |
| Criar produto, oferta, cupom ou checkout | API do vendedor |
| Matricular aluno e montar o curso na área de membros | API do vendedor |
| Aprovar afiliado, aprovar ou recusar reembolso | API do vendedor |
| Ver saldo, extrato e pedir saque | API do vendedor |
| Cadastrar e testar webhooks | API do vendedor: `POST /v1/webhooks` |

> [!NOTE]
>
> Quem vende pelo checkout da Ephra quase nunca precisa da API de cobranças: o checkout cobra e o webhook avisa. Nesse caso, comece pela API do vendedor e pelos [webhooks](https://docs.ephra.io/webhooks/visao-geral.md).

## Diferenças que aparecem no código

| | API de cobranças | API do vendedor |
| - | - | - |
| Lista | `offset`, com o total em `totalRows` (vendas) ou `totalCount` (webhooks) | `page`, `pageSize` e `pagination` |
| Erro de validação | `400` | `422` |
| Corpo de erro | `success: false` e `message`, às vezes com `error`, `code` ou `details` | sempre só `success: false` e `message` |

Veja [Status e erros](https://docs.ephra.io/api-reference/status-e-erros.md) para a lista completa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.