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

SET Direct Deposit API · Sender wallets

Register a sender wallet

POST/api/partner/senders

Key scope: partner key · Success: 201

Registers a wallet you pay from, with the wallet's own signature of the message above: personal_sign from an ordinary wallet, or EIP-1271 checked on chain for a contract wallet such as a Safe. Payouts from a registered wallet are credited to you and carry your Travel Rule data.

Body

chain "base" | "ethereum"required
As signed.
address stringrequired
As signed.
issuedAt ISO timerequired
From the message call.
signature hex stringrequired
The wallet's signature of the message.
label string
Your name for the wallet.

Notes

  • A wallet belongs to one partner (409 sender_taken). Registering again answers registered: false with the existing record.
  • Late attribution: a payout from this wallet in the last 30 days that arrived as payout.unknown_sender is credited to you now, and its Travel Rule data is sent (lateAttribution).

Errors

  • 400 body_invalid
  • 400 chain_invalid
  • 400 address_invalid
  • 400 issued_at_invalid
  • 400 signature_expired
  • 400 signature_invalid
  • 422 signature_not_from_wallet
  • 409 sender_taken
  • 409 merchant_no_senders
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.