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

SET API (Platforms) · Payable Email

Report a Payable Email payment

POST/v1/payable_emails/payments

Key scope: write · Success: 201

Records a USDC payment you sent from your own registered wallet to a claimable payee's wallet on Base. SET checks it on chain: from one of your registered wallets, to the wallet SET created for that payee, within the amount limits. Idempotent on txHash. Payments to a direct payee's Cash-Out Address need no report.

Headers

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

Body

payeeId stringrequired
pye_….
chain "base"required
Claimable payments are on Base.
txHash stringrequired
The transaction.

Errors

  • 400 body_invalid
  • 400 chain_invalid
  • 400 tx_hash_invalid
  • 404 payee_unknown
  • 409 payment_not_claimable
  • 409 payment_not_found
  • 409 payment_failed
  • 409 payment_mismatch
  • 409 sender_unregistered
  • 409 amount_out_of_range
  • 409 tx_already_reported
  • 502 chain_unavailable
  • 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.