> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a Payout Group
> Define where rewards are sent and at what rate.
A payout group is the foundation of the Rewards Engine. It specifies the destination address that receives reward payouts and carries the jurisdiction designation that determines the earnings rate. All reward addresses registered to a group accrue and pay out collectively to that group's destination.
Create one payout group per chain per jurisdiction before registering any reward addresses.
> **Required scope:** `rewards:create_payout_groups`
## Create a payout group
Use [Create a Payout Group](/api-reference/endpoints/payout-groups/create-payout-group). Include a `schedule` to configure when reward payouts are triggered — the example below creates a daily schedule that pays out at 02:00 UTC:
```bash highlight={5,6,7,8,9,10,11,12,13} theme={null}
curl -X POST 'https://api.sandbox.paxos.com/v2/rewards/payout-groups' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-d '{
"ledger": "ETHEREUM",
"asset_type": "USDG",
"jurisdiction": "NON_EU",
"name": "USDG Ethereum Non-EU",
"claimer_address": "{claimer_address}",
"schedule": {
"schedule_type": "DAILY",
"hour": 2,
"minute": 0
}
}'
```
```json highlight={3,4} theme={null}
{
"group": {
"id": "{payout_group_id}",
"destination_address": "{destination_address}",
"ledger": "ETHEREUM",
"asset_type": "USDG",
"jurisdiction": "NON_EU",
"name": "USDG Ethereum Non-EU",
"claimer_address": "{claimer_address}",
"balance": "0",
"created_at": "2024-01-15T10:00:00Z",
"updated_at": "2024-01-15T10:00:00Z"
}
}
```
Save the `id` returned in the response — you will reference it as `{payout_group_id}` when registering reward addresses.
> `claimer_address` applies only to on-chain (EVM contract) integrations — it is the address that signs and submits claim transactions directly to the rewards smart contract. For off-chain integrations, Paxos executes payouts directly and this field is not used for signing. `destination_address` is where reward payouts are sent; it defaults to `claimer_address`.
Register your `destination_address` as a reward address in this payout group. If the destination address is not registered for monitoring, reward payouts will not compound — you will earn a simple rate (APR) rather than a compounded rate (APY).
## Key fields
| Field | Description |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ledger` | The blockchain network (e.g. `ETHEREUM`, `SOLANA`). Payout groups are chain-specific — create a separate group for each chain. |
| `asset_type` | The stablecoin this group tracks (e.g. `USDG`, `PYUSD`). |
| `jurisdiction` | `EU` or `NON_EU`. Maps to the contractual earnings rate agreed at the partner level. |
| `claimer_address` | For on-chain (EVM contract) integrations: the address that signs and submits claim transactions to the rewards smart contract. Not used for signing in off-chain integrations. |
| `destination_address` | The address that receives reward payouts. Defaults to `claimer_address` if not set separately. |
## Claim schedule
The `schedule` field on the create request configures when rewards are automatically paid out for this payout group. If omitted, a default daily schedule is created automatically.
### Schedule types
| `schedule_type` | Description | Additional fields |
| --------------- | --------------------------------------------------------- | ---------------------------------------------------------------- |
| `DAILY` | Runs every day at the specified `hour` and `minute` (UTC) | None |
| `WEEKLY` | Runs on specific days of the week | `days_of_week` — array of day numbers (0 = Sunday, 6 = Saturday) |
| `MONTHLY` | Runs on specific days of the month | `days_of_month` — array of day numbers (1–31) |
`hour` and `minute` are in UTC. For example, `"hour": 2, "minute": 0` triggers at 02:00 UTC. The `next_run_at` field in the response shows when the first payout will execute.
To adjust the schedule after the payout group is created, use [Update Claim Schedule](/api-reference/endpoints/claims/update-claim-schedule).
**Claims are best effort.** Payouts may be delayed beyond the scheduled time for the following reasons:
* **Network conditions**: Block production rates and congestion vary across chains and can delay transaction submission and confirmation.
* **Reconciliation gating**: Paxos runs a reconciliation check before executing any claim. Delays in reconciliation jobs or failure-remediation timelines will push back the payout window.
## Payout group status
The `onchain_status` field on the payout group reflects its on-chain registration state.
| Status | Description |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| `UNREGISTERED` | Not yet registered on-chain |
| `PENDING_REGISTRATION` | On-chain registration in progress |
| `ACTIVE` | Registered and active; reward addresses in this group are accruing |
| `FAILED_REGISTRATION` | Registration failed; contact support if this persists |
| `PENDING_MULTIPLIER_UPDATE` | A jurisdiction or rate change is being applied on-chain |
| `MULTIPLIER_UPDATE_FAILED` | The on-chain rate update failed; the group is still active but the update must be retried |
| `PENDING_DELETION` | Deletion in progress |
| `FAILED_DELETION` | On-chain deletion failed; contact support |
## Next step
Submit the blockchain addresses to monitor for rewards