SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-10
Browse: SET Direct Deposit API

SET Direct Deposit API · Payable Email

Add emails to a batch

POST/api/partner/payees/batch/{id}/items

Key scope: partner key

Up to 20 more emails, each resolved as POST /api/partner/payees would, numbered after the batch's own items and on the batch's chain. A batch holds up to 5,000 items. The answer is the whole batch, with payTo covering every payable item so far.

Path parameters

id stringrequired
pbt_….

Body

items [{ email, amount?, reference? }]required
1–20 items. References must be unique in the batch.

Notes

  • 409 batch_busy: another page was being added to this batch at the same moment. Nothing from your call was added; send the same page again.
  • 409 batch_full: the batch already holds 5,000 items, or this page would take it over. Start a new batch.
  • Emails are resolved while you wait, 20 a call, and are never stored. See Batches of up to 5,000.

Errors

  • 400 body_invalid
  • 400 items_invalid
  • 400 batch_too_large
  • 400 reference_repeated
  • 404 batch_unknown
  • 409 batch_full
  • 409 batch_busy
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 403 ip_not_allowed
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.