Aprenda como os membros podem resgatar seu saldo de carteira por descontos e créditos.

Resgate

Os membros podem resgatar seu saldo disponível por valor real. Rafobase suporta múltiplos métodos de resgate dependendo da sua plataforma de checkout.

Métodos de Resgate

Método	Plataforma	Descrição
Desconto de Assinatura	Guru	Aplicar crédito ao próximo cobro de assinatura
Crédito de Loja	Yampi	Gerar um cupom de desconto
Pagamento Manual	Todos	Processar pagamento fora do sistema

Pré-requisitos

Antes de um membro poder resgatar:

Saldo Disponível > 0 (créditos pendentes não contam)
Valor Mínimo atendido (se configurado na campanha)
Status do Membro é ativo

// Verifique se o membro pode resgatar
const canRedeem = member.status === 'active' && member.wallet.available >= campaign.min_redemption

Desconto de Assinatura (Guru)

Aplique o crédito do membro como desconto no próximo cobro de assinatura.

curl -X POST "https://api.rafobase.com/v1/members/mem_xxxxx/redeem" \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "type": "subscription_discount",
    "subscription_id": "sub_xxxxx"
  }'

{
  "id": "red_xxxxx",
  "member_id": "mem_xxxxx",
  "amount": 2000,
  "type": "subscription_discount",
  "status": "completed",
  "metadata": {
    "subscription_id": "sub_xxxxx",
    "guru_discount_id": "disc_xxxxx"
  },
  "created_at": "2024-01-15T10:30:00Z"
}

Como Funciona

Rafobase debita a carteira do membro
Chama a API do Guru para aplicar desconto à assinatura
O próximo cobro é reduzido pelo valor do desconto
O desconto é de uso único e expira automaticamente

O desconto se aplica ao próximo cobro de assinatura. Se o cobro for menor que o desconto, o restante é perdido.

Crédito de Loja (Yampi)

Gere um cupom de desconto de uso único que o membro pode usar no checkout.

curl -X POST "https://api.rafobase.com/v1/members/mem_xxxxx/redeem" \
  -H "Authorization: Bearer $RAFOBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "type": "store_credit"
  }'

{
  "id": "red_xxxxx",
  "member_id": "mem_xxxxx",
  "amount": 5000,
  "type": "store_credit",
  "status": "completed",
  "metadata": {
    "coupon_code": "CREDIT-JOHN-5000",
    "expires_at": "2024-02-15T23:59:59Z"
  },
  "created_at": "2024-01-15T10:30:00Z"
}

Como Funciona

Rafobase debita a carteira do membro
Cria um cupom de desconto no Yampi
Retorna o código do cupom para o membro
Membro usa o cupom na próxima compra

Os cupons de crédito de loja expiram após 30 dias por padrão. Cupons não utilizados não podem ser restaurados à carteira.

Resgate Parcial vs Completo

Resgate Parcial

Resgate apenas parte do saldo disponível:

{
  "amount": 2000, // Resgate R$20 de R$50 disponível
  "type": "subscription_discount"
}

Resgate Completo

Resgate todo o saldo disponível:

{
  "amount": null, // null = saldo disponível completo
  "type": "subscription_discount"
}

Resgate

On this page