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

SET Direct Deposit API · Sandbox

Simulate a payment into a payee's wallet

POST/api/partner/sandbox/payments

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

Staging only. A payment from you into the wallet SET created for a payee (status: "claimable"), in_wallet at once under a simulated txHash, with the event payable_payment.in_wallet. Reporting that hash with POST /api/partner/payments answers the same payment. No money moves.

Body

payeeId stringrequired
pye_… from POST /api/partner/payees.
amount decimal stringrequired
USDC, at least 2.00.
chain "base"
Default base.

Errors

  • 400 amount_invalid
  • 400 amount_out_of_range
  • 404 payee_unknown
  • 409 payment_not_claimable
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 403 ip_not_allowed
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.