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

SET Direct Deposit API · Sandbox

Simulate a batch's multisend

POST/api/partner/sandbox/payments/batch

Key scope: partner key · Staging only · Success: 201

Staging only. One simulated transaction paying every payable item of a batch, as a Safe's multisend would: each claimable item with an amount becomes a payment in_wallet, each direct item at a stand-in Cash-Out Address a simulated payout, each with its reference. Reporting the txHash with POST /api/partner/payments/batch answers the payments.

Body

batchId stringrequired
pbt_… from POST /api/partner/payees/batch.

Errors

  • 404 batch_unknown
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 403 ip_not_allowed
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.