Merchant User Guide

Manual POS Merchants

Reward State Transitions

Understand how threshold rewards move through the settlement pipeline.

1 min read

When a customer completes a threshold (verified points reach the required amount), the reward enters a pipeline with clear state transitions that ensure proper accounting.

Reward pipeline

1

Threshold completed

Customer's verified points reach or exceed the threshold requirement. Reward state changes from 'none' to 'pending_settlement'.

2

Pending settlement

The reward is queued and its dollar value adds to the merchant's pending settlement balance. This is visible in the Finance ledger.

3

Merchant settles

When the merchant processes settlement, pending rewards move to 'in_pool' status. The reward value transfers from pending settlement into the SVC Pool balance.

4

SVC Pool active

The customer's reward is now funded and available as SVC credit. The merchant's SVC Pool balance reflects the total funded value.

Merchant User Guide