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

Pré-requisitos

Antes de um membro poder resgatar:

Saldo Disponível > 0 (créditos pendentes não contam)
Status do Membro é ativo

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

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/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"
  }'

{
  "success": true,
  "data": {
    "memberId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amountRedeemed": 2000,
    "destination": "guru_subscription",
    "newBalance": {
      "totalEarned": 5000,
      "totalRedeemed": 4000,
      "available": 1000,
      "pending": 0,
      "cancelled": 0
    },
    "integration": {
      "provider": "guru",
      "subscriptionId": "sub_xxxxx",
      "appliedCycles": 1
    }
  }
}

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/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"
  }'

{
  "success": true,
  "data": {
    "memberId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amountRedeemed": 5000,
    "destination": "yampi_coupon",
    "newBalance": {
      "totalEarned": 10000,
      "totalRedeemed": 9000,
      "available": 1000,
      "pending": 0,
      "cancelled": 0
    },
    "integration": {
      "provider": "yampi",
      "code": "RESGATE-ABCD-1A2B3C",
      "id": "12345"
    }
  }
}

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:

{
  "email": "customer@example.com",
  "amount": 2000,
  "destination": "guru_subscription",
  "subscriptionId": "sub_xxxxx"
}

Resgate Completo

Para resgatar todo o saldo disponível, informe o valor total disponível na carteira:

{
  "email": "customer@example.com",
  "amount": 5000,
  "destination": "guru_subscription",
  "subscriptionId": "sub_xxxxx"
}

Resgate

On this page