---
title: "Create Recharge"
method: POST
path: "/api/v1/recharge/create"
tags: ["recharge"]
---

# Create Recharge

`POST /api/v1/recharge/create`

Create a recharge order with transparent fee handling.

## Request body

- RechargeCreateRequest
  - `recharge_amount` number, required — Amount to add to balance
  - `payment_method` 'alipay' | 'wechat' | 'credit_card' | 'sbp' | 'ru_card' — Payment method (whitelist enforced at schema layer). Note: 'crypto' (manual) NOT in whitelist — manual flow goes through mailto/Telegram, not /recharge/create.
  - `language` string — User language

## Response `200`

Successful Response

- RechargeCreateResponse
  - `success` boolean, required
  - `message` string
  - `order_id` string
  - `qr_url` string
  - `payment_url` string
  - `provider` string
  - `recharge_amount` number
  - `total_amount` number
  - `fee_amount` number

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/qcode/apis/qcode-web.md) · [All operations](https://skmtc.dev/qcode/apis/qcode-web/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qcode/qcode-web/revisions/2f2f5f49ffc7/schema)