---
title: "Simulate Deposit"
method: POST
path: "/v1/customers/{customer_id}/simulate-transactions"
tags: ["Simulations"]
---

# Simulate Deposit

`POST /v1/customers/{customer_id}/simulate-transactions`

Simulates a deposit transaction for testing purposes. **Only available in non-production environments.** 

**Asset & Network Requirements** 

- For token assets (USDT, USDC, MXNB), network is required and must be a wallet network (e.g., ETHEREUM).
- For currency assets (USD), network must be a bank network (US_ACH, US_FEDWIRE, US_RTP, SWIFT, CUBIX, BANK_TRANSFER, PIX_TRANSFER).
- **Amount Limit**: Simulation amount must be greater than zero and cannot exceed 1000.

**Deposit Status Simulation** 

Use the `simulate_status` field to simulate different deposit states:

| Value | Description |
|-------|-------------|
| `FAILED` | Simulates a failed deposit |

**Example:** `{ "asset": "USD", "network": "US_ACH", "amount": "100.00", "simulate_status": "FAILED" }`

## Path parameters

- `customer_id` string, required

## Request body

- SimulateTransactionRequest
  - `asset` string, required — - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC - Fiat currencies: USD
  - `network` string, required
  - `amount` string, required — Deposit amount
  - `reference_code` string, nullable — Optional reference-code/memo/message for the transaction (only used for fiat deposits)
  - `simulate_status` string, nullable — Optional simulation status for sandbox testing. Supported values: "FAILED"

## Response `201`

- SimulateTransactionResponse
  - `simulation_id` string, required — Transaction ID
  - `status` 'PENDING' | 'COMPLETED' | 'FAILED' | 'REVERSED' | 'RETURNED', required
  - `created_at` string, required
  - `modified_at` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `405` — Method Not Allowed
- `422` — Unprocessable Entity - Invalid enum value (e.g., unsupported network or asset name)
- `500` — Internal Server Error

---

[API](https://skmtc.net/1money/apis/1money-openapi.md) · [All operations](https://skmtc.net/1money/apis/1money-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/1money/1money-openapi/revisions/aa2718d28cb5/schema)