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

SET Direct Deposit API · Payable Email

Pay up to 20 emails at once

POST/api/partner/payees/batch

Key scope: partner key · Success: 201

Resolves up to 20 emails in one call, each exactly as POST /api/partner/payees would, and returns payTo: the {address, amountUsdc, reference} list for one multisend transaction (direct and claimable items only). An item that cannot be resolved is status: "error" with its code; the rest still resolve.

Body

chain "base" | "ethereum"required
As for a single payee.
items [{ email, amount?, reference? }]required
1–20 items. References must be unique in the batch.

Notes

  • SET stores neither the emails nor the references; references are echoed only in this answer.
  • GET /api/partner/payees/batch/{id} returns the batch with each item's payments (404 batch_unknown).

Errors

  • 400 body_invalid
  • 400 chain_invalid
  • 400 items_invalid
  • 400 batch_too_large
  • 400 reference_repeated
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.