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

SET Direct Deposit API · Payable Email

Report a multisend

POST/api/partner/payments/batch

Key scope: partner key · Success: 201

Records every USDC transfer in one transaction from your registered wallets to wallets SET created for your payees, once each. Transfers to anyone else are listed under skipped with a reason. Reporting again records nothing new.

Body

chain "base"required
Claimable payments are on Base.
txHash stringrequired
The multisend transaction.
batchId string
The batch it paid (pbt_…).

Notes

  • Skip reasons: not_a_claimable_payee, sender_unregistered, ambiguous_sender, amount_out_of_range. A payment is unique per transaction and payee, so POST /api/partner/payments for one payee of a multisend also works.

Errors

  • 400 tx_hash_invalid
  • 404 batch_unknown
  • 409 payment_not_found
  • 409 payment_mismatch
  • 409 payment_failed
  • 409 tx_already_reported
  • 502 chain_unavailable
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.