Get a sandbox key

You can try the SET API and the SET Direct Deposit API now, without waiting for SET. One call gives you a test key. Nothing a test key does moves money, and every simulated result is labelled.

Ask for a key

curl -X POST https://wallet-staging.simpleeasytransactions.com/api/sandbox/keys \
  -H "Content-Type: application/json" \
  -d '{"company": "Acme Payments Ltd", "country": "USA", "product": "set-api"}'

The answer carries the key once. SET keeps only its hash, so copy it then:

{
  "object": "sandbox_key",
  "product": "set-api",
  "key": "set_test_…",
  "partner": "ptr_sbx_…",
  "sandbox": true,
  "expiresAt": "2026-12-09T23:21:57.177Z"
}

SET asks for no email address and no personal details, and stores none.

First call

SET API:

curl https://wallet-staging.simpleeasytransactions.com/v1/ping \
  -H "Authorization: Bearer set_test_…"

SET Direct Deposit API:

curl https://wallet-staging.simpleeasytransactions.com/api/partner/statement \
  -H "Authorization: Bearer set_partner_…"

From there, follow Use cases and Sandbox scenarios. A Direct Deposit sandbox registers its paying wallet first (Sender wallets).

Limits of a self-serve sandbox

• It lasts 30 days. Ask for another when it ends.
• Writes are limited to a few a minute. Reads follow the limits in the RateLimit-* headers.
• A limited number of new sandboxes is issued each day. When they are gone the call answers 429 sandbox_keys_exhausted.
• It works on the staging host only. A test key is refused by production, and production issues no keys this way.

For a sandbox without these limits, or a live key, write to SET. A live key is issued after SET has verified your business (KYB policy).

Tools

Both APIs publish an OpenAPI 3.1 document that needs no key to read:

• Postman, Insomnia, Bruno: choose Import and paste the document's address. Each call arrives with its fields. Set the base address to the staging host and your test key as the bearer token.
• A typed client: any OpenAPI generator builds one from the same document, for example npx @openapitools/openapi-generator-cli generate -i https://simpleeasytransactions.com/openapi/set-api.json -g typescript-fetch -o ./set-api-client. SET does not publish its own client libraries.
• Errors, idempotency and webhooks work the same in the sandbox: Errors, Idempotency, Webhooks and events.