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=a1b2c3d4-e5f6-7890-abcd-ef1234567890
RAFOBASE_WEBHOOK_SECRET=whsec_a1b2c3d4e5f678900abcdef1234567890

Crie uma Campanha

Campanhas são criadas exclusivamente pelo painel administrativo:

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

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/api/webhooks/guru/{SEU_MERCHANT_ID}
- 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/api/webhooks/yampi/{SEU_MERCHANT_ID}
- 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 "https://api.rafobase.com/api/v1/member/me?email=customer@example.com&name=Jo%C3%A3o%20Silva&externalId=cust_123&autoCreate=true" \
  -H "X-API-Key: $RAFOBASE_API_KEY"

Resposta:

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "customer@example.com",
    "name": "João Silva",
    "referralCode": "NUT-JOAOS-A7B3C",
    "referralLink": "https://nuture.com.br/?cupom=NUT-JOAOS-A7B3C",
    "status": "active",
    "wallet": {
      "totalEarned": 0,
      "totalRedeemed": 0,
      "available": 0,
      "pending": 0,
      "cancelled": 0
    }
  },
  "created": true
}

O membro recebe um código de cupom único (ex: NUT-JOAOS-A7B3C) 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 - [ ] Verifique assinaturas de webhook em produção - [ ] Configure monitoramento de erros - [ ] Configure períodos de garantia apropriados

Início Rápido

On this page