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

SET Merchant API · Sandbox

Simulate an unknown sender

POST/v1/sandbox/unknown_sender

Key scope: write · Staging only · Success: 201

Staging only. A simulated payment into a Cash-Out Address from a wallet nobody named. It is held with senderState: "unknown_sender" and told as cash_out_payment.unknown_sender. It cannot advance until POST /v1/cash_out_payments/{id}/sender names its sender, which credits it and sends cash_out_payment.funds_received. No money moves.

Headers

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

Body

cashOutAddress stringrequired
A Cash-Out Address of yours on staging.
amount decimal stringrequired
At least "1.00".
senderAddress stringrequired
The simulated sending wallet. It is returned here and carried on the event, not stored on the payment.

Notes

  • This hold exists only in the sandbox. Outside it, a payment whose sender is not named yet reads senderState: "none" and is not held.

Errors

  • 400 amount_invalid
  • 400 sender_invalid
  • 404 cash_out_address_unknown
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 401 api_key_expired
  • 403 scope_missing
  • 403 platform_api_paused
  • 429 rate_limited
  • 503 api_disabled

All codes: Errors.