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

SET Merchant API · Static memos

Open a static memo

POST/v1/static_memos

Key scope: write · Success: 201

A shared USD deposit account where each payer includes a memo: payers send a wire or an ACH push quoting memo, and the stablecoin is delivered less SET's fee, as with a USD virtual account. Cheaper than an account per merchant when many payers share one.

Merchant key A merchant's destination wallet is always its own: beneficiary.type must be "customer"; "platform" is refused with 400 beneficiary_invalid.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

customer stringrequired
An approved customer endorsed for USD.
asset, address, beneficiary as virtual accounts
The stablecoin and chain delivered, the wallet, and whose wallet it is (Travel Rule).
settleTo { wallet }
Instead: deliver USDC into one of the customer's own custodial wallets.
platformFeeBps integer
Platform keys: the platform's own fee, once SET allows it.

Notes

  • Payers must quote the memo; a payment without it is delayed or returned. Deposit instructions are read live for each answer and never stored.
  • No microdeposit or challenge-deposit verification on a shared account (supportsMicrodeposits: false).
  • The provider has superseded static memos with static templates but keeps supporting them; every answer carries a deprecation note. New integrations: static templates.
  • Events static_memo.created, static_memo_deposit.<state>.

Errors

  • 400 asset_invalid
  • 400 address_invalid
  • 400 beneficiary_invalid
  • 400 static_memo_refused
  • 404 wallet_unknown
  • 409 settle_route_not_supported
  • 409 static_memo_conflict
  • 409 verification_incomplete
  • 409 endorsement_required
  • 403 platform_fee_not_allowed
  • 409 customer_closed
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.