Indicações

Uma indicação é uma venda rastreada que foi atribuída a um membro via seu código de cupom único. Quando um novo cliente usa o cupom de um membro no checkout, o Rafobase cria um registro de indicação e credita a carteira do membro.

Fluxo de Indicação

Novo Cliente            Checkout            Rafobase              Membro
     │                      │                   │                    │
     │  Usa código de cupom │                   │                    │
     │─────────────────────►│                   │                    │
     │                      │   Webhook pedido  │                    │
     │                      │──────────────────►│                    │
     │                      │                   │  Crie indicação    │
     │                      │                   │  Credite carteira  │
     │                      │                   │────────────────────►│
     │                      │                   │   (PENDENTE)       │
     │                      │                   │                    │
     │                      │                   │  Após garantia     │
     │                      │                   │────────────────────►│
     │                      │                   │   (DISPONÍVEL)     │

Propriedades da Indicação

Propriedade	Tipo	Descrição
`id`	string	Identificador único (`ref_xxxxx`)
`member_id`	string	O indicador que recebe crédito
`referee_email`	string	Email do novo cliente
`referee_external_id`	string	Seu ID para o novo cliente
`order_id`	string	ID de pedido externo do checkout
`order_value`	number	Valor total do pedido em centavos
`reward_amount`	number	Recompensa calculada em centavos
`status`	enum	`pending`, `approved`, `rejected`, `cancelled`
`created_at`	datetime	Quando a indicação foi criada

Status da Indicação

Status	Descrição	Efeito na Carteira
`pending`	Aguardando período de garantia	Credita saldo pendente
`approved`	Garantia passou, válida	Credita saldo disponível
`rejected`	Falhou na validação (fraude, etc.)	Sem crédito
`cancelled`	Pedido reembolsado/cancelado	Reverte crédito

Transições de Status

              ┌───────────┐
              │  pending  │
              └─────┬─────┘
                    │
         ┌──────────┼──────────┐
         ▼          ▼          ▼
    ┌─────────┐ ┌─────────┐ ┌─────────┐
    │approved │ │rejected │ │cancelled│
    └─────────┘ └─────────┘ └─────────┘

Cálculo de Recompensa

A recompensa é calculada com base nas configurações da sua campanha:

Baseada em Percentual

reward = order_value × (campaign.reward_percentage / 100)

Exemplo: Recompensa de 10% em pedido de R$200 = R$20

Valor Fixo

reward = campaign.fixed_reward_amount

Exemplo: Recompensa fixa de R$15 independentemente do valor do pedido

A recompensa é creditada ao saldo pendente do membro imediatamente, depois se move para saldo disponível após o período de garantia expirar.

Período de Garantia

O período de garantia protege contra:

Cancelamentos de pedido
Reembolsos
Contestações

Durante este período:

O crédito está em status pending
O membro não pode resgatar este crédito
Se o pedido for cancelado/reembolsado, o crédito é automaticamente revertido

Períodos de garantia típicos: 7-30 dias

Validação Anti-Fraude

Rafobase valida automaticamente as indicações para prevenir fraude de auto-indicação:

Verificação	Descrição
Correspondência de Email	Email do indicado ≠ Email do indicador
Correspondência de CPF	CPF do indicado ≠ CPF do indicador (se disponível)
Mesmo Lar	Verificações opcionais de IP/dispositivo

Validações com falha resultam em status rejected com um código de motivo.

Visualizando Indicações

Painel

Navegue para Indicações para ver todas as indicações com opções de filtro:

Por status
Por membro
Por intervalo de data
Por valor do pedido

API

# Liste todas as indicações
curl https://api.rafobase.com/v1/referrals \
  -H "Authorization: Bearer $RAFOBASE_API_KEY"

# Obtenha indicação específica
curl https://api.rafobase.com/v1/referrals/ref_xxxxx \
  -H "Authorization: Bearer $RAFOBASE_API_KEY"

# Filtrar por membro
curl "https://api.rafobase.com/v1/referrals?member_id=mem_xxxxx" \
  -H "Authorization: Bearer $RAFOBASE_API_KEY"

Relacionado

Membros - Quem pode fazer indicações
Carteira - Como os créditos funcionam
Guia de Webhooks - Configurando webhooks de pedidos

Indicações

On this page