Skip to main content
POST
/
simulate
/
fiat
/
deposits
Simulate fiat deposit
curl --request POST \
  --url https://api.stabyl.com/v1/simulate/fiat/deposits \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "50000.00",
  "currency": "NGN",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "idempotency_key": "sim_fiat_dep_001"
}
'
{
  "data": {
    "amount": "50000.00",
    "reference": "SIM-FIAT-DEP-001",
    "status": "confirmed",
    "transaction_id": "0197f1f0-0000-7000-8000-000000000004"
  },
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Simulation endpoints are available only outside production. Use them to test integration behavior without moving real funds.

Body

application/json

Non-production fiat deposit event to create for integration testing.

Non-production fiat deposit event to create for integration testing.

​
amount
string
required
Example:

"50000.00"

​
currency
string
required
Example:

"NGN"

​
user_id
string<uuid>
required
​
idempotency_key
string | null
Example:

"sim_fiat_dep_001"

Response

Simulated deposit created

​
data
object
required

Result returned after creating a non-production fiat deposit event.

​
status
enum<string>
required
Available options:
success