SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-08
Browse: SET API (Platforms)

SET API (Platforms) · Return addresses

Register default return addresses

POST/v1/return_addresses

Key scope: write

Registers once where returned payments go for every Cash-Out or Conversion Address opened afterwards without its own returnAddress. One EVM address serves Base and Ethereum. GET /v1/return_addresses reads them. Event return_addresses.updated.

Platform key Refused (403 platform_funds_not_allowed) unless SET has allowed platform funds for the platform: a returned payment would reach the platform, which would then hold its merchant's money. GET still reads.

Body

evm string
0x address for Base and Ethereum.
solana string
Solana address.

Errors

  • 400 return_address_invalid
  • 403 platform_funds_not_allowed
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.