SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-09
Browse: SET Merchant API

SET Merchant API · Recipients & payouts

Pay up to 100 recipients at once

POST/v1/payout_batches

Key scope: write · Success: 201

Prefunded payouts: up to 100 items from one funded wallet. Every item is checked before anything is sent (recipient, owner, amount, fee); a bad item is refused with its index and nothing is created. The wallet must hold the batch total. Items are queued and sent, the first 10 at once and the rest in the background.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

wallet stringrequired
The funded wallet.
items [{ recipient, amount, externalId? }]required
1–100 items. No per-item reference: use single payouts for bank references.
externalId string
Your id for the batch; a retry returns the same objects.

Notes

  • Each item is an ordinary payout with its own events. The batch is processing, then submitted, then completed once every item is final: events payout_batch.created, .submitted, .completed.

Errors

  • 400 items_invalid
  • 400 reference_not_supported
  • 400 external_id_repeated
  • 409 external_id_taken
  • 413 payload_too_large
  • 400 amount_invalid
  • 400 amount_too_small
  • 400 reference_invalid
  • 400 external_id_invalid
  • 400 recipient_other_customer
  • 404 recipient_unknown
  • 404 wallet_unknown
  • 409 recipient_disabled
  • 409 recipient_incomplete
  • 409 payee_not_ready
  • 409 balance_too_low
  • 409 initiation_required
  • 403 operator_cannot_pay_out
  • 403 platform_fee_not_allowed
  • 503 bridge_wallets_disabled
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.