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 API
Simulate Fiat Received
Simulate the receipt of fiat funds for an onramp order (Sandbox only)
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
orderIdto simulate the fiat deposit - The order will progress through
funded→completedstatus - You’ll receive
order_updatedwebhooks 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'
})
});