Skip to main content
For sandbox / demo integrations only. Use a SANDBOX API key and the demo API base URL your Stable Sea contact provides. After you create an order, call this endpoint when you are ready to simulate that the customer funded the order. The response matches Get order so you can refresh your UI from the returned JSON or by polling GET /organizations/{organization_id}/orders/{order_id}. This route is not available on live integrations or environments outside the hosted demo stack.

When to use

  • The order status is awaiting funding and you do not have a real bank transfer in demo.
  • You need to exercise polling and downstream statuses on your own timeline.
If the order is already funded, completed, or not eligible (wrong product path), the API returns an error with a stable message—do not retry in a tight loop.

Common headers

HeaderValueRequiredDescription
AuthorizationBearer <api-key>trueSANDBOX API key
Content-Typeapplication/jsontrueContent type of the request

Path parameters

organization_id
string
required
Organization ID (must match the organization tied to your API key)
order_id
string
required
Order ID in awaiting funding state

Body

JSON object. Use {} or include an optional request_id string for tracing (does not change funding behavior).
request_id
string
Optional client reference or idempotency token; logged only.

Code examples

curl -X POST "https://api-sandbox.stablesea.com/v1/organizations/{organization_id}/orders/{order_id}/simulate-demo-funding" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'