Membros
Entendendo membros - os clientes que participam do seu programa de indicação.
Membros
Membros são clientes que participam do seu programa de indicação como indicadores. Cada membro recebe um código de cupom único que pode compartilhar com outros.
Ciclo de Vida do Membro
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Criado │ ───► │ Ativo │ ───► │ Gerando │
│ │ │ │ │ │
│ Sem ref │ │ Tem código │ │ Tem refs │
└─────────────┘ └─────────────┘ └─────────────┘Propriedades do Membro
| Propriedade | Tipo | Descrição |
|---|---|---|
id | string | Identificador único (mem_xxxxx) |
email | string | Email do membro (único por merchant) |
name | string | Nome de exibição |
external_id | string | ID do cliente do seu sistema |
coupon_code | string | Código de indicação único |
campaign_id | string | Campanha associada |
status | enum | active, inactive, blocked |
wallet | object | Informações de saldo atual |
Criando Membros
Os membros podem ser criados de duas formas:
1. Via API (Recomendado)
Melhor para integração controlada onde você decide quem pode participar.
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": "your_customer_id",
"campaign_id": "camp_xxxxx"
}'2. Registro Automático via Webhook
Configure campanhas para registrar automaticamente clientes como membros quando fizerem sua primeira compra.
O registro automático é útil para negócios de assinatura onde todo cliente deve se tornar automaticamente um indicador.
Códigos de Cupom
Cada membro recebe um código de cupom único seguindo o padrão:
{PREFIXO}-{PARTE_DO_NOME}-{ALEATORIO}Exemplo: NUT-JOAO-A7X
- PREFIXO: Seu prefixo de marca (configurado nas configurações)
- PARTE_DO_NOME: Primeiras 4 letras do nome do membro
- ALEATORIO: Sufixo alfanumérico aleatório
O código de cupom é:
- Case-insensitive no checkout
- Validado contra sua plataforma de checkout
- Usado para atribuição (não como mecanismo de desconto por padrão)
Visão Geral da Carteira
Todo membro tem uma carteira associada com dois saldos:
- Pendente: Créditos de indicações recentes, ainda em período de garantia
- Disponível: Créditos que podem ser resgatados
Veja Carteira para informações detalhadas.
Status do Membro
| Status | Descrição |
|---|---|
active | Pode receber indicações e resgatar |
inactive | Temporariamente desabilitado |
blocked | Bloqueado por fraude ou violação de política |
Melhores Práticas
Dicas para Gerenciamento de Membros - Sempre use external_id para ligar membros ao seu
sistema - Configure registro automático para negócios de assinatura primeiro - Monitore membros
inativos e re-engaje-os - Revise membros bloqueados periodicamente
Relacionado
- Indicações - Como as indicações são rastreadas
- Carteira - Gerenciamento de saldo
- API de Membros - Endpoints de API