Entendendo o sistema de carteira - saldos pendentes e disponíveis em moeda real.

Carteira

Todo membro tem uma carteira que rastreia seus ganhos com indicações. Ao contrário de programas de fidelidade tradicionais com pontos arbitrários, Rafobase usa moeda real (R$).

Saldos da Carteira

Cada carteira tem dois saldos:

Saldo	Descrição
Pendente	Créditos de indicações recentes, ainda dentro do período de garantia
Disponível	Créditos que podem ser resgatados

{
  "wallet": {
    "totalEarned": 20000,
    "totalRedeemed": 5000,
    "available": 15000,
    "pending": 5000,
    "cancelled": 0
  }
}

Todos os valores monetários na API são representados em centavos para evitar problemas de precisão de ponto flutuante.

Sistema de Ledger

A carteira usa um padrão de ledger imutável. Os saldos nunca são atualizados diretamente - em vez disso, toda mudança cria um novo registro de transação.

┌────────────────────────────────────────────────────────────────────────┐
│                          LEDGER DA CARTEIRA                           │
├──────────┬────────┬───────────┬──────────┬────────────────────────────┤
│   Data   │  Tipo  │  Status   │  Valor   │       Descrição            │
├──────────┼────────┼───────────┼──────────┼────────────────────────────┤
│ 1º Jan   │ credit │ available │ +R$20.00 │ Indicação aprovada         │
│ 10 Jan   │ credit │ available │ +R$15.00 │ Indicação aprovada         │
│ 12 Jan   │ debit  │ used      │ -R$20.00 │ Resgate via assinatura     │
│ 20 Jan   │ credit │ cancelled │ +R$15.00 │ Pedido reembolsado         │
└──────────┴────────┴───────────┴──────────┴────────────────────────────┘

Tipos de Transação

Tipo	Descrição
`credit`	Recompensa de indicação creditada
`debit`	Resgate/saque processado

Status de Transação

Status	Descrição
`pending`	Crédito em período de garantia
`available`	Crédito liberado, pode ser resgatado
`used`	Débito confirmado (resgate concluído)
`cancelled`	Crédito cancelado (pedido reembolsado)
`reversed`	Estorno (contestação/chargeback)
`processing`	Débito em processamento

Fluxo de Saldo

Verificando Saldo

API

# Obtenha membro com carteira
curl "https://api.rafobase.com/api/v1/member/me?email=customer@example.com" \
  -H "X-API-Key: $RAFOBASE_API_KEY"

Histórico de Transações

# Obtenha transações da carteira
curl "https://api.rafobase.com/api/v1/wallet/transactions?email=customer@example.com" \
  -H "X-API-Key: $RAFOBASE_API_KEY"

Resgate

Os membros podem resgatar seu saldo disponível de várias formas:

1. Desconto em Assinatura (Guru)

Aplique crédito como desconto no próximo cobro de assinatura:

curl -X POST "https://api.rafobase.com/api/v1/wallet/redeem" \
  -H "X-API-Key: $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "amount": 2000,
    "destination": "guru_subscription",
    "subscriptionId": "sub_xxxxx"
  }'

2. Gerar Crédito de Loja (Yampi)

Crie um código de cupom para a loja:

curl -X POST "https://api.rafobase.com/api/v1/wallet/redeem" \
  -H "X-API-Key: $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "amount": 5000,
    "destination": "yampi_coupon"
  }'

O resgate só afeta o saldo disponível. O saldo pendente não pode ser resgatado até que o período de garantia expire.

Moeda

Rafobase atualmente suporta BRL (Real Brasileiro). Todos os valores são armazenados e exibidos em centavos.

Relacionado

Membros - Proprietários da carteira
Indicações - Como os créditos são ganhos
Guia de Resgate - Fluxos de resgate detalhados

Carteira

On this page