Wallet and Payments

This flow explains how customers use internal wallet balance, gift cards, and payment history.

What customers can do

• View available and frozen balances
• Redeem valid gift cards into wallet
• Pay eligible orders from available balance
• View balance change history for audit and support

Balance model

• Available balance: spendable for order payment
• Frozen balance: temporarily locked and not spendable

Both are shown as part of one wallet account per user.

Gift card redemption

1. User enters gift card code.
2. System validates card status (exists, unused, unexpired).
3. Value is deposited into available balance.
4. Card is marked redeemed and cannot be reused.

Paying orders with wallet

1. User selects wallet payment.
2. System checks available balance.
3. Amount is deducted and order moves to paid status in one transaction.
4. Payment record appears in balance history.

Balance history

History is used for:

• customer transparency
• support troubleshooting
• finance reconciliation

Each record contains amount change, change type, reason, and timestamp.

What customers cannot do

• Spend frozen balance
• Redeem an expired or already-used gift card
• Partially bypass payment rules with insufficient available balance
• Directly edit or delete wallet history records