Comece com o Rafobase em 5 minutos. Configure sua primeira campanha de indicação.

Início Rápido

Execute seu programa de indicação em 5 minutos.

Antes de começar, certifique-se de ter acesso ao seu painel do Rafobase e à plataforma de checkout (Guru ou Yampi).

Pré-requisitos

Uma conta do Rafobase com credenciais de API
Acesso à sua plataforma de checkout (Guru ou Yampi)
Compreensão básica de REST APIs e webhooks

Etapas de Configuração

Obtenha Suas Credenciais de API

Faça login no Painel do Rafobase e navegue até Configurações → Chaves de API.

Copie:

Chave de API (para chamadas servidor-para-servidor)
Segredo do Webhook (para verificar webhooks recebidos)

# Armazene estes com segurança em suas variáveis de ambiente
RAFOBASE_API_KEY=rfb_live_xxxxxxxxxxxxx
RAFOBASE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxx

Crie uma Campanha

Uma campanha define as regras para suas recompensas de indicação.

Vá para Campanhas → Criar Campanha
Defina o tipo de recompensa (percentual ou valor fixo)
Defina o período de garantia (dias antes do crédito ficar disponível)
Salve e ative

curl -X POST https://api.rafobase.com/v1/campaigns \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Programa de Indicação Padrão",
    "reward_type": "percentage",
    "reward_value": 10,
    "warranty_days": 7,
    "is_active": true
  }'

Configure Webhooks

Aponte sua plataforma de checkout para o Rafobase para receber eventos de pedidos.

Vá para Painel Guru → Configurações → Webhooks
Adicione um novo webhook:
- URL: https://api.rafobase.com/webhooks/guru
- Eventos: transaction.approved, transaction.refunded
Copie o segredo gerado para o painel do Rafobase

Vá para Painel Yampi → Configurações → Integrações
Ative webhooks e defina:
- URL: https://api.rafobase.com/webhooks/yampi
- Eventos: order.paid, order.status.updated
Salve o segredo do webhook

Registre Seu Primeiro Membro

Os membros são clientes que podem indicar outros. Registre-os via API:

curl -X POST https://api.rafobase.com/v1/members \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "name": "João Silva",
    "external_id": "cust_123",
    "campaign_id": "camp_xxxxx"
  }'

Resposta:

{
  "id": "mem_xxxxx",
  "email": "customer@example.com",
  "name": "João Silva",
  "coupon_code": "NUT-JOAO-A7X",
  "wallet": {
    "pending": 0,
    "available": 0
  }
}

O membro recebe um código de cupom único (ex: NUT-JOAO-A7X) que pode compartilhar com amigos.

Teste o Fluxo

Membro compartilha seu código de cupom com um amigo
Amigo usa o cupom no checkout
Checkout envia webhook para o Rafobase
Rafobase atribui a venda e credita a carteira do membro

Você pode verificar no painel em Indicações para ver a venda atribuída.

Próximos Passos

Agora que você tem o básico configurado:

Entenda o Sistema de Carteira - Aprenda sobre saldo pendente vs disponível
Configure o Resgate de Membros - Permita que membros usem seus créditos
Regras Anti-Fraude - Configure prevenção de fraude
Referência de API - Explore todos os endpoints disponíveis

Checklist de Produção - [ ] Mude de chaves de API de teste para chaves ao vivo - [ ] Verifique assinaturas de webhook em produção - [ ] Configure monitoramento de erros - [ ] Configure períodos de garantia apropriados

Início Rápido

On this page