Skip to main content
POST
/
v1
/
ramp
/
org
/
simulate-transaction
Simulate On-Ramp Transaction
curl --request POST \
  --url https://api.example.com/v1/ramp/org/simulate-transaction
Endpoint: POST https://api.rebelfi.io/v1/ramp/org/simulate-transaction
This endpoint is only available in the sandbox environment. It will return an error in production.
Simulate an on-ramp transaction lifecycle to test your integration. The simulation progresses the transaction through the specified scenario’s status sequence.

​
Request Body

FieldTypeRequiredDescription
scenariostringNoSimulation scenario (default: "success" — options: success, failed, rejected, reversed)
usd_amountnumberNoSimulated USD amount (default: 50000)
onramp_account_idnumberNoOn-ramp account ID to simulate against

​
Scenarios

ScenarioStatus Progression
successpending -> processing -> in_progress -> broadcasted -> completed
failedpending -> processing -> failed
rejectedpending -> rejected
reversedpending -> processing -> in_progress -> broadcasted -> completed -> reversed

​
Example Request

curl -X POST "https://api.rebelfi.io/v1/ramp/org/simulate-transaction" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "scenario": "success",
    "usd_amount": 10000,
    "onramp_account_id": 1
  }'

​
Example Response

{
  "success": true,
  "data": {
    "simulation_id": "sim_a1b2c3d4e5f6",
    "state": "accepted"
  }
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the simulation was accepted
data.simulation_idstringUnique identifier for the simulation
data.statestringSimulation state (accepted)