A API do Refera em 5 minutos.

A Refera expõe uma API REST autenticada por Bearer token pra você integrar seu sistema de pagamento com o programa de indicação. O fluxo é: quando uma venda acontece no seu backend com um referral_code, você chama o Refera pra registrar a venda — nós criamos a comissão, checamos metas e pagamos por PIX.

Fluxo mínimo

1. 1. Gera uma API key no dashboard da empresa (Configurações → API keys).
2. 2. Seu backend recebe o webhook de pagamento (Stripe, PagBank, Asaas, ou o próprio checkout).
3. 3. Extrai referral_code do metadata da compra + valor pago.
4. 4. POST /api/v1/sales com esses dados.
5. 5. Recebe a comissão criada — o vendedor vê o saldo dele em segundos.

Exemplo end-to-end

Registra uma venda de R$ 149,90 usando o código do vendedor:

curl -X POST https://refera.com.br/api/v1/sales \
  -H "Authorization: Bearer rfr_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "referral_code": "PZMUDXJD",
    "campaign_id": "c64d34c8-...",
    "plan_id": "eb1a683e-...",
    "amount_brl": 149.90,
    "external_ref": "stripe_cs_test_01"
  }'

Resposta (201 Created):

{
  "sale_id": "a8f2c341-...",
  "commission_id": "d1b78e05-...",
  "commission_amount_brl": 14.99,
  "idempotent": false
}