> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherfuse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulate Fiat Received

> Simulate the receipt of fiat funds for an onramp order (Sandbox only)

**Sandbox environment only** - This endpoint is only available at `https://api.sand.etherfuse.com`

Simulates the receipt of fiat funds for an onramp order. This allows you to test the complete onramp flow without actually sending money.

When creating an onramp order, the customer would normally need to send MXN to the `depositClabe` returned in the order response. In the sandbox environment, you can use this endpoint to simulate that deposit and trigger the order to proceed to completion.

## Flow

1. Create an onramp order via `POST /ramp/order`
2. Call this endpoint with the `orderId` to simulate the fiat deposit
3. The order will progress through `funded` → `completed` status
4. You'll receive `order_updated` webhooks as the order progresses

<Note>
  This endpoint returns an error if called in production environments.
</Note>

## Authentication

<ParamField header="Authorization" type="string" required>
  Your sandbox API key
</ParamField>

## Request Body

<ParamField body="orderId" type="string" required>
  The UUID of the onramp order to simulate fiat received for
</ParamField>

## Response

<ResponseField name="200">
  Fiat received simulation successful. The order will now progress to completion.
</ResponseField>

<ResponseField name="400">
  Invalid request. Possible reasons:

  * This endpoint is only available in sandbox or localnet environments
  * The order is not in 'created' status
  * The order is not an onramp order
</ResponseField>

<ResponseField name="404">
  Order not found
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.sand.etherfuse.com/ramp/order/fiat_received \
    -H "Authorization: your-sandbox-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "orderId": "123e4567-e89b-12d3-a456-426614174000"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.sand.etherfuse.com/ramp/order/fiat_received', {
    method: 'POST',
    headers: {
      'Authorization': 'your-sandbox-api-key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      orderId: '123e4567-e89b-12d3-a456-426614174000'
    })
  });
  ```
</RequestExample>