How Do I Integrate Points Redemption with the Flutter SDK (v2, Legacy)?

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.

Pay with Points

Redeem points directly as cash discounts

Convert Points to Coupons

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:

Check Balance

Verify customer has sufficient points for redemption

Calculate Discount

Determine the discount amount based on point value

Apply to Order

Apply the discount to the customer’s order total

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:

Show Common Redemption Rules

Minimum Points Required

Set minimum points required for redemption
Prevent redemption of small amounts

Maximum Redemption Limit

Set daily/monthly redemption limits
Control cash flow and fraud prevention

Point Value Configuration

Define how many points equal 1 currency unit
Configure exchange rates for different currencies

Category Restrictions

Restrict redemption for specific product categories
Allow redemption only for eligible items

Time-based Restrictions

Set redemption windows (e.g., business hours only)
Implement seasonal redemption campaigns

Testing Redemption

Test Balance Check

Verify customer balance API returns correct values

Test Redemption Process

Test both direct debit and coupon redemption flows

Verify Point Deduction

Ensure points are correctly deducted after redemption

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.

Overview

Web & POS Integration

Mobile Integration

How Do I Integrate Points Redemption with the Flutter SDK (v2, Legacy)?

Pay with Points

Convert Points to Coupons

Reward Vouchers

Custom Redemption

Redemption Implementation Methods

Check Customer Balance

Flutter Implementation

Direct Debit Redemption

Implementation Example

Coupon Redemption

Flutter Implementation

Redemption UI Integration

Show Redemption Options

Redemption Rules

Minimum Points Required

Maximum Redemption Limit

Point Value Configuration

Category Restrictions

Time-based Restrictions

Testing Redemption

Best Practices

Pay with Points

Convert Points to Coupons

Reward Vouchers

Custom Redemption

​Redemption Implementation Methods

​Check Customer Balance

​Flutter Implementation

​Direct Debit Redemption

​Implementation Example

​Coupon Redemption

​Flutter Implementation

​Redemption UI Integration

​Show Redemption Options

​Redemption Rules

​Minimum Points Required

​Maximum Redemption Limit

​Point Value Configuration

​Category Restrictions

​Time-based Restrictions

​Testing Redemption

​Best Practices

Redemption Implementation Methods

Check Customer Balance

Flutter Implementation

Direct Debit Redemption

Implementation Example

Coupon Redemption

Flutter Implementation

Redemption UI Integration

Show Redemption Options

Redemption Rules

Minimum Points Required

Maximum Redemption Limit

Point Value Configuration

Category Restrictions

Time-based Restrictions

Testing Redemption

Best Practices