Rafobase Logo

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

PropriedadeTipoDescrição
idstringIdentificador único (mem_xxxxx)
emailstringEmail do membro (único por merchant)
namestringNome de exibição
external_idstringID do cliente do seu sistema
coupon_codestringCódigo de indicação único
campaign_idstringCampanha associada
statusenumactive, inactive, blocked
walletobjectInformaçõ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

StatusDescrição
activePode receber indicações e resgatar
inactiveTemporariamente desabilitado
blockedBloqueado 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

On this page