POST /preferences (Aggregator)

POST/preferences

Provide settlement info for a merchant of an aggregator. Use POST to add (initial) and PUT to update.

Headers

Header	Required	Description
`content-type`	Yes	`application/json`
`apikey`	Yes	Your API key
`signature`	Yes	HMAC-SHA384 signature
`nonce`	Yes	Current Unix timestamp

Request body

{
  "merchant_id": "Merchant ID",
  "payout_accounts": [
    {
      "wallet_title": "My USDT Wallet",
      "address": "0x00556a16efc8bbfa9cd462c4ae31bee126efcba2",
      "currency": "USDT",
      "percentage": "100%"
    }
  ],
  "payout_cycle": "Monthly"
}

Field reference

Field	Type	Description
`merchant_id`	string	Merchant ID from onboarding response
`payout_accounts`	array	List of settlement wallets
`payout_accounts[].wallet_title`	string	Label for the wallet
`payout_accounts[].address`	string	Wallet address
`payout_accounts[].currency`	string	Settlement currency (e.g. `USDT`)
`payout_accounts[].percentage`	string	Percentage of settlement to this wallet
`payout_cycle`	string	`Daily`, `Weekly`, or `Monthly`

Success response (200)

{ "message": "OK" }

Error response (400)

{ "error": true, "message": "description for error" }

POST is called only once per merchant to add settlement info. Use PUT to update later.

Next steps

Update Merchant Profile — PUT /settings
Aggregator Overview — full PSP flow

Merchant Settlement Info