---
title: "Deposit"
method: POST
path: "/api/wallet/deposits"
tags: ["wallet"]
---

# Deposit

`POST /api/wallet/deposits`

## Request

- Base URL: `https://esimker.com` (the document declares no server; this is the origin it was published from)
- URL: `https://esimker.com/api/wallet/deposits`
- Auth: none declared

A top-up: the same providers and the same webhooks as an order, only the
thing being paid for is credit. The pay page sends the buyer back to the
wallet page with the deposit's token, which the page then reports on.

## Headers

- `X-Wallet-Code` string, nullable

## Request body

- DepositIn
  - `amount_usd` union, required
    - number
    - string
  - `payment_method` string
  - `payment_gateway` string, nullable
  - `lang` string, nullable
  - `currency` string, nullable

## Response `200`

Successful Response

- DepositOut
  - `deposit` object, required
  - `checkout_url` string, required
  - `pay` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/esimker/apis/esimker-api.md) · [All operations](https://skmtc.dev/esimker/apis/esimker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/esimker/apis/esimker-api/revisions/13ea312e6990?raw)