> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Loyalty Program Payouts

Reward customers automatically when they reach a milestone - a points threshold, a tier upgrade, or a number of purchases - with digital value they can redeem instantly.

### How it works

1. Register customers as consumers when they join your loyalty program
2. Listen for milestone events in your system (e.g. customer reaches Gold tier)
3. Trigger a wallet credit via the Orbt API when the event fires

### Example: reward a customer reaching Gold tier

```text theme={null}
POST /api/partner/v1/wallets/{walletId}/transactions
{
  "amount": 20.00,
  "transactionType": "CREDIT",
  "referenceId": "loyalty-gold-upgrade-customer-4821",
  "description": "Gold tier welcome reward"
}
```

The `referenceId` ties the credit to a specific event in your system and prevents it from being applied twice if the request is retried.