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

SET Merchant API · Conversion

Open a Conversion Address

POST/v1/conversion_addresses

Key scope: write · Success: 201

Crypto to crypto: stablecoin sent to the address is converted or moved across chains and delivered to the wallet named (for example USDC on Base to USDC on Solana, or USDC to EURC).

Merchant key A merchant's destination wallet is always its own: beneficiary.type must be "customer"; "platform" is refused with 400 beneficiary_invalid. Without returnAddress, the merchant's own registered return address is used (POST /v1/return_addresses).

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.
chain stringrequired
The chain payers send on.
currency "usdc" | "usdt" | "pyusd" | "eurc"required
The stablecoin it accepts.
destination { asset, address, beneficiary }required
Where it is delivered and whose wallet that is.
returnAddress string
Where a payment that cannot be delivered returns.

Errors

  • 400 currency_invalid
  • 400 asset_invalid
  • 400 route_not_supported
  • 400 beneficiary_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.