Status: Stable reservation flow.
Pending confirmation: Final external payout processing timings.

Members: Redeem Points

Use this endpoint to reserve points for redemption and create payout tracking state.

This does not mean the payout has completed.

Endpoint

POST /api/v1/redemptions

What happens

More Rewards:

1. authenticates the club key
2. validates member payout readiness
3. checks available member points
4. calculates redemption cash value
5. reserves points
6. reserves scheme payout capacity
7. creates payout tracking state

Request body

{
  "partnerRef": "club_public_id",
  "requestId": "redemption_external_id",
  "member": {
    "externalMemberId": "member_external_id"
  },
  "redemption": {
    "points": 2000,
    "currency": "GBP"
  }
}

Calculation

cashValueMinor = points * redemptionRateMinorPerPoint

Success response

{
  "ok": true,
  "data": {
    "redemptionId": "k57exampleid",
    "status": "payout_pending",
    "externalMemberId": "member_external_id",
    "pointsRedeemed": 2000,
    "cashValueMinor": 2000,
    "currency": "GBP",
    "payout": {
      "payoutId": "j12exampleid",
      "status": "created"
    },
    "balances": {
      "pointsBalance": 1400,
      "reservedPointsBalance": 2000
    }
  }
}

Check redemption progress

curl https://api.more-rewards.co.uk/api/v1/redemptions/k57exampleid \
  -H "X-MR-Key-Id: club_live_example" \
  -H "X-MR-Timestamp: 2026-03-25T09:16:00Z" \
  -H "X-MR-Signature: v1=<computed_signature>"

Common errors

• insufficient_points_balance
• missing_payout_reference
• insufficient_partner_cash_capacity
• partner_funding_restricted
• minimum_redemption
• invalid_redemption_points
• invalid_redemption_value
• partner_configuration_incomplete