Skip to main content
Enable your customers to redeem their rewarded points. Through Gameball, you can allow your customers to redeem and use their collected points as discounts while placing new orders on your website. Those points are exchanged for discount coupons or free service/product vouchers during future purchases. Learn more about points redemption. For e-commerce businesses, points redemption is done with order placement using Order API. A pre-step to that would be checking the customer’s balance - using Customer Points Balance API if there are enough points or not for the transaction; and showing the customer his balance.

Direct Debit

Redeem points directly as cash discounts

Coupon Redemption

Exchange points for discount coupons

Reward Vouchers

Convert points to gift vouchers

Custom Redemption

Create custom redemption options

​
Redemption Implementation Methods

There are two main ways to implement redemption in your Flutter app:
Option 1: Use Gameball’s built-in redemption UI through the SDK Option 2: Build your own custom redemption interface using the Redemption API

​
Check Customer Balance

Before allowing redemption, check the customer’s available balance: 
GET https://api.gameball.co/api/v3.0/integrations/customer/balance/{playerUniqueId}
apiKey: your_api_key

​
Flutter Implementation

// Check customer balance
Future<Map<String, dynamic>?> checkCustomerBalance(String customerId) async {
  try {
    final response = await http.get(
      Uri.parse('${your_backend_url}/customer/$customerId/balance'),
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer ${customer_token}',
      },
    );

    if (response.statusCode == 200) {
      final balance = jsonDecode(response.body);
      return balance;
    } else {
      print('Failed to get balance: ${response.statusCode}');
      return null;
    }
  } catch (e) {
    print('Error getting balance: $e');
    return null;
  }
}

​
Direct Debit Redemption

For direct debit redemption, customers can use their points as cash discounts:
1

Check Balance

Verify customer has sufficient points for redemption
2

Calculate Discount

Determine the discount amount based on point value
3

Apply to Order

Apply the discount to the customer’s order total
4

Update Balance

Deduct the redeemed points from customer’s balance

​
Implementation Example

// Process direct debit redemption
Future<bool> processDirectDebitRedemption(
  String customerId, 
  double orderTotal, 
  int pointsToRedeem
) async {
  try {
    final response = await http.post(
      Uri.parse('${your_backend_url}/redeem/direct-debit'),
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer ${customer_token}',
      },
      body: jsonEncode({
        'customerId': customerId,
        'orderTotal': orderTotal,
        'pointsToRedeem': pointsToRedeem,
      }),
    );

    if (response.statusCode == 200) {
      final result = jsonDecode(response.body);
      // Handle successful redemption
      return true;
    } else {
      print('Redemption failed: ${response.statusCode}');
      return false;
    }
  } catch (e) {
    print('Error processing redemption: $e');
    return false;
  }
}

​
Coupon Redemption

For coupon-based redemption, customers exchange points for discount coupons: 
POST https://api.gameball.co/api/v3.0/integrations/transaction/redeem
Content-Type: application/json
apiKey: your_api_key

{
  "playerUniqueId": "customer_123",
  "amount": 100,
  "transactionId": "TXN-12345"
}

​
Flutter Implementation

// Generate coupon from points
Future<String?> generateCoupon(String customerId, int pointsToRedeem) async {
  try {
    final response = await http.post(
      Uri.parse('${your_backend_url}/redeem/coupon'),
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer ${customer_token}',
      },
      body: jsonEncode({
        'customerId': customerId,
        'pointsToRedeem': pointsToRedeem,
      }),
    );

    if (response.statusCode == 200) {
      final result = jsonDecode(response.body);
      return result['couponCode'];
    } else {
      print('Coupon generation failed: ${response.statusCode}');
      return null;
    }
  } catch (e) {
    print('Error generating coupon: $e');
    return null;
  }
}

​
Redemption UI Integration

​
Show Redemption Options

You can integrate redemption options into your Flutter app UI: 
// Show redemption dialog
void showRedemptionDialog(BuildContext context, String customerId) {
  showDialog(
    context: context,
    builder: (BuildContext context) {
      return AlertDialog(
        title: Text('Redeem Points'),
        content: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('Choose how you want to redeem your points:'),
            SizedBox(height: 16),
            ElevatedButton(
              onPressed: () => processDirectDebitRedemption(customerId, 0, 0),
              child: Text('Direct Debit'),
            ),
            ElevatedButton(
              onPressed: () => generateCoupon(customerId, 0),
              child: Text('Generate Coupon'),
            ),
          ],
        ),
      );
    },
  );
}

​
Redemption Rules

Configure redemption rules in your Gameball dashboard:

​
Testing Redemption

1

Test Balance Check

Verify customer balance API returns correct values
2

Test Redemption Process

Test both direct debit and coupon redemption flows
3

Verify Point Deduction

Ensure points are correctly deducted after redemption
4

Test Edge Cases

Test with insufficient balance, maximum limits, and invalid requests

​
Best Practices

  • Always validate customer balance before allowing redemption
  • Implement proper error handling for failed redemption attempts
  • Provide clear feedback to customers about redemption status
  • Log all redemption transactions for audit purposes
Make sure to handle redemption failures gracefully. If the redemption API is unavailable, inform the customer and suggest retrying later.