---
title: "Simulate Order Status Update"
method: POST
path: "/v3/simulation/order"
tags: ["Simulation"]
---

# Simulate Order Status Update

`POST /v3/simulation/order`

Simulates a status transition for an existing order in the sandbox environment. The status update is processed asynchronously and triggers the corresponding webhooks for the target status.

## Headers

- `MID` string, required

## Request body

- object
  - `orderId` string, required — The order ID to update. Must start with "OR-" or "PF-".
  - `status` string, required — Target status to simulate for the order (e.g. fund_settled, fund_deposited, fund_failed). [Allowed statuses](https://docs.transfi.com/docs/order-status-simulation#allowed-statuses-by-order-type)
  - `errorCode` string — Optional error code to attach when simulating a failed status.. [Allowed codes](https://docs.transfi.com/docs/order-status-simulation#allowed-error-codes)

## Response `202`

Order status update accepted for processing

- object
  - `status` string
  - `data` object
    - `message` string
    - `code` string

## Other responses

- `400` — Validation error
- `500` — Internal server error

---

[API](https://skmtc.net/transfi/apis/transfi-single-integrated-api.md) · [All operations](https://skmtc.net/transfi/apis/transfi-single-integrated-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfi/transfi-single-integrated-api/revisions/adb1b62e58cf/schema)