---
title: "🧪 Create a deposit"
method: POST
path: "/simulate/deposit"
tags: ["Payment", "snbx"]
---

# 🧪 Create a deposit

`POST /simulate/deposit`

## Headers

- `IdempotencyKey` string — A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 255 characters. See [Idempotent Requests](/docs/idempotent-requests).

## Request body

- object
  - `amount` integer, required — Non-negative integer amount in lowest currency denomination. See [Money](/docs/money) for details.
  - `deposit_account_id` string, uuid, required — A [Universally Unique Identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier)
  - `payer_bankname` string — Non-empty text string
  - `payer_country` string — ISO 3166-1 alpha-2 country code
  - `payer_name` string — Non-empty text string
  - `reference` string — Non-empty text string
  - `statement_ref` string — Non-empty text string
  - `status` 'pending' | 'settled' | 'rejected'

## Response `200`

Successful operation

- object
  - `amount` integer, required — Non-negative integer amount in lowest currency denomination. See [Money](/docs/money) for details.
  - `deposit_account_id` string, uuid, required — A [Universally Unique Identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier)
  - `payer_bankname` string — Non-empty text string
  - `payer_country` string — ISO 3166-1 alpha-2 country code
  - `payer_name` string — Non-empty text string
  - `reference` string — Non-empty text string
  - `statement_ref` string — Non-empty text string
  - `status` 'pending' | 'settled' | 'rejected'
  - `currency` string, required — ISO 4217 currency code
  - `created_at` string, date-time, required
  - `deposit_type` 'debit' | 'credit', required
  - `fee_amount` integer — Non-negative integer amount in lowest currency denomination. See [Money](/docs/money) for details.
  - `fee_currency` object
    - `currency_code` string, required — ISO 4217 currency code
    - `precision` integer, required — Integer amount in lowest currency denomination. See [Money](/docs/money) for details.
    - `value` string, required — Non-empty text string
  - `id` string, uuid, required — A [Universally Unique Identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier)

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/revisions/bfbcd2bfed61/schema)