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

SET API (Platforms) · Payable Email

Pay an email address

POST/v1/payable_emails

Key scope: write · Success: 201

Where to pay this person: direct (their Cash-Out Address, paid to their bank), claimable (a new wallet only that email can open, on Base), setup_required or invited. The same SET Payable Email as the Direct Deposit API.

Headers

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

Body

email stringrequired
The payee's email. Sent to the sign-in provider only.
chain "base" | "ethereum"
Default base. A new payee is paid on Base only.

Notes

  • Pay the address from your own registered wallet (a payment to a claimable wallet is reported with POST /v1/payable_emails/payments), or make the email a recipient (destination: {kind: "email"}) and pay it from a custodial wallet with POST /v1/payouts.
  • The platform's own Payable Email switch and daily cap on new wallets apply.

Errors

  • 400 chain_invalid
  • 409 claim_needs_base
  • 403 payable_email_merchant
  • 403 payable_email_off
  • 503 payable_email_disabled
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.