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

SET Direct Deposit API · References

Set a payout reference

POST/api/partner/references

Key scope: partner key

Tags a payment with your own id (a bounty, contest or invoice id). SET returns it on every event, statement row, payment list and 1099 line about that payment. Set it before or after SET sees the payment. reference: null removes it.

Body

chain "base" | "ethereum"
Default base.
txHash stringrequired
The payment's transaction.
to string
In a multisend, the one recipient it is for. Without it, every recipient of the transaction.
reference string | nullrequired
1–64 visible ASCII characters: your own id, never a person's name or email.

Notes

  • References are sealed at rest.

Errors

  • 400 body_invalid
  • 400 chain_invalid
  • 400 tx_hash_invalid
  • 400 to_invalid
  • 400 reference_invalid
  • 404 reference_unknown
  • 503 references_unconfigured
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.