Simulator

Simulator endpoints are staging-only helpers for operators using simulator wallet adapter.

Availability

• onboarding and staging
• not production integration path
• operator must have balance_adapter_type = simulator

Paths

• POST /api/operator/simulator/operations
• GET /api/operator/simulator/operations/{idempotencyKey}
• GET /api/operator/simulator/wallets/{externalUserId}
• PUT /api/operator/simulator/wallets/{externalUserId}

Operation create body

{
  "external_user_id": "operator-user-123",
  "direction": "debit",
  "amount_minor": 10000,
  "idempotency_key": "demo-op-123"
}

Allowed directions

• debit
• credit
• debit_reversal
• credit_reversal

Failure cases

• simulator not enabled -> 404 SIMULATOR_DISABLED
• unknown operator user -> 404 OPERATOR_USER_NOT_FOUND
• invalid direction -> 400 INVALID_DIRECTION