Create a Payout Group

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

Use Create a 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:

Show Request

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
    }
  }'

Show Response

{
  "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.

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

Register Reward Addresses

Submit the blockchain addresses to monitor for rewards

Get Started

Identity

Travel Rule

Stablecoin Orchestration

Fiat Transfers

Rewards Engine

Address Verification

Stablecoin Payments

Crypto Brokerage

Webhooks

Additional Guides

Versioning

Create a Payout Group