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

SET Merchant API · Payers

Save a payer

POST/v1/payers

Key scope: write · Success: 201

Saves a payer before it pays, by the wallet it pays from. Every payment from that wallet is then named for the Travel Rule automatically, and open payments from it are named at once (alsoNamed). A bank sender is saved from a payment instead, with "remember": true on that payment's /sender call.

Body

wallet stringrequired
0x… (Base and Ethereum) or a Solana address.
payer objectrequired
The payer, same body as /sender.

Notes

  • SET stores only a keyed hash of the wallet and seals the payer's details at rest. Do not save payroll providers, exchanges or other services that pay for many people.

Errors

  • 400 wallet_invalid
  • 400 sender_invalid
  • 403 payers_merchant_only
  • 503 payers_disabled
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.