Скопировано в буфер
Wallet MC
API v1

Wallet MC API

Добро пожаловать в документацию Wallet MC API. Наш интерфейс предоставляет разработчикам удобные инструменты для интеграции кошелька с Minecraft серверами, магазинами, Telegram-ботами и другими сервисами.

Базовый URL API

https://walletmc.ru/api/external.php

Авторизация

Все запросы к API должны быть авторизованы с использованием вашего секретного API ключа. Вы можете передать ключ одним из двух способов.

Способ 1: HTTP Заголовок (Рекомендуется) 
Authorization: Bearer sk_live_ВашСекретныйКлюч123
Способ 2: В теле JSON 
{
  "api_key": "sk_live_ВашСекретныйКлюч123",
  "action": "get_user",
  "identifier": "WMC-12345"
}

Рекомендации и правила

  • Все запросы должны выполняться с использованием метода POST.
  • Формат Content-Type должен быть строго application/json.
  • Держите ваш API ключ в секрете. Никогда не встраивайте его в клиентский код (HTML/JS) или мобильные приложения.
  • Суммы (amount) всегда передаются в рублях (₽) и могут содержать до двух знаков после запятой (например, 150.50).
  • Всегда проверяйте поле success: true в ответе перед обработкой логики.
POST

Получить пользователя

Возвращает информацию о профиле пользователя и его текущий баланс. Вы можете искать пользователя как по уникальному Wallet ID, так и по номеру телефона.

Request Body 
{
  "action": "get_user",
  "identifier": "WMC-A1B2C3D4"
}
Response (200 OK) 
{
  "success": true,
  "message": "User found.",
  "data": {
    "id": 1,
    "wallet_id": "WMC-A1B2C3D4",
    "phone": "+7 (999) 000-00-00",
    "first_name": "Иван",
    "last_name": "Иванов",
    "balance": 1500.50
  }
}
POST

Списание средств

Безопасно списывает средства с баланса игрока. Идеально подходит для реализации доната или покупок внутри игры. Вернет ошибку, если средств недостаточно.

Request Body 
{
  "action": "withdraw_balance",
  "identifier": "WMC-A1B2C3D4",
  "amount": 250.00,
  "description": "Покупка VIP-статуса"
}
Response (200 OK) 
{
  "success": true,
  "message": "Balance withdrawn successfully.",
  "data": {
    "new_balance": 1250.50
  }
}
POST

Пополнение средств

Зачисляет средства на баланс пользователя. Удобно для выдачи наград за турниры, возвратов или интеграции с внешними платежными шлюзами.

Request Body 
{
  "action": "topup_balance",
  "identifier": "+7 (999) 000-00-00",
  "amount": 500,
  "description": "Награда за турнир"
}
Response (200 OK) 
{
  "success": true,
  "message": "Balance topped up successfully.",
  "data": {
    "new_balance": 1750.50
  }
}
POST

Перевод между счетами

Выполняет транзакционный перевод средств от одного пользователя другому. Если у отправителя недостаточно средств, транзакция будет безопасно отменена.

Request Body 
{
  "action": "transfer_funds",
  "from_identifier": "WMC-SENDER12",
  "to_identifier": "WMC-RECEIV34",
  "amount": 100,
  "description": "Сделка на аукционе"
}
Response (200 OK) 
{
  "success": true,
  "message": "Transfer successful.",
  "data": null
}