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

SET Direct Deposit API · Payout intents

Reserve one payout for a reference

POST/api/partner/payout_intents

Key scope: partner key · Success: 201

Answers where to pay an amount, once per reference (your bounty, contest or invoice id). A second intent for the same reference is refused with the first one in the answer, so a retry, a double click or a second worker never pays twice. Pay the address, then set the reference on the payment (POST /api/partner/references) and the intent is paid: event payout_intent.paid.

Body

reference stringrequired
Your own id: 1–64 visible ASCII characters, never a person's name or email.
amountUsdc decimal stringrequired
The USDC you mean to pay.
chain "base" | "ethereum"
Default base.
address string
A payee's Cash-Out or Threshold Address. Send this or payeeId.
payeeId string
A Payable Email payee (pye_…), resolved now with this amount.

Notes

  • 409 already_intended (an open intent) and 409 already_paid carry the first intent as intent: pay that one, or nothing.
  • An amount that would not reach the bank after SET's fee is 422 below_minimum rather than an address. See Paying each reference once.
  • The reference is kept as a keyed hash (to find it) and sealed (to show it back), never in clear.

Errors

  • 400 body_invalid
  • 400 reference_invalid
  • 400 chain_invalid
  • 400 amount_invalid
  • 400 amount_out_of_range
  • 400 destination_invalid
  • 404 payee_unknown
  • 404 address_unknown
  • 409 already_intended
  • 409 already_paid
  • 409 payee_not_payable
  • 422 below_minimum
  • 503 references_unconfigured
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 403 ip_not_allowed
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.