---
title: "Create Sandbox Deposit"
method: POST
path: "/v1/sandbox/deposits"
tags: ["public.deposits"]
---

# Create Sandbox Deposit

`POST /v1/sandbox/deposits`

Creates a mock deposit for an existing funding account for testing purposes. funding_account_scope defaults to CUSTOMER. Set it to MERCHANT when funding_account_id is the id returned by GET /v1/merchant/funding. Merchant simulations accept currency=NGN with a required amount to credit withdrawal_balance_ngn, or currency=USD with an optional amount to credit withdrawal_balance_usd; omitting both preserves the legacy fixed 10 USD simulation. The endpoint uses the selected scope and does not search both account types. Pass scenario to force a deterministic sandbox deposit lifecycle outcome. payout_scenario is only supported for CUSTOMER deposits. Only available in sandbox.

## Headers

- `X-Idempotency-Key` string

## Request body

- GithubComDayaxyzDayaExternalApiCmdServerHandlersTypesCreateSandboxDepositRequest
  - `amount` string
  - `currency` 'USD' | 'NGN' — Merchant funding simulations only. Omit both fields to preserve the legacy fixed 10 USD simulation.
  - `funding_account_id` string, required
  - `funding_account_scope` 'CUSTOMER' | 'MERCHANT'
  - `payout_scenario` 'DEFAULT' | 'PROCESSING' | 'SETTLED' | 'FAILED'
  - `scenario` 'DEFAULT' | 'PROCESSING' | 'COMPLETED' | 'REQUIRES_REVIEW' | 'FAILED'

## Response `202`

Accepted

- GithubComDayaxyzDayaExternalApiCmdServerHandlersTypesCreateSandboxDepositResponse
  - `deposit_id` string
  - `message` string
  - `payout_scenario` string
  - `scenario` string
  - `status` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Not available outside sandbox
- `404` — Funding account not found
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)