Qual API usar - Ephra

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.

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.

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`

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.

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 para a lista completa.