Simulate Fiat Received

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"
  }'

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'
  })
});

POST

ramp

order

fiat_received

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"
  }'

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'
  })
});

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

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

This endpoint returns an error if called in production environments.

Authentication

string

required

Your sandbox API key

Request Body

string

required

The UUID of the onramp order to simulate fiat received for

Response

Fiat received simulation successful. The order will now progress to completion.

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

Order not found

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"
  }'

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'
  })
});

Set partner fee Generate onboarding URL

⌘I

User Authentication

Ramp API

Lookup API

Flow

Authentication

Request Body

Response

​Flow

​Authentication

​Request Body

​Response

Flow

Authentication

Request Body

Response