🚀 Быстрый старт и процесс обмена

Получите API токен у администратора системы
Используйте /api/get_rate для получения актуального курса UAH/USDT
Создайте заявку через /api/get_card с суммой в UAH
Переведите точную сумму на полученную карту (не больше, не меньше)
Подтвердите оплату в нашем боте @cardchange_bot отправкой чека
Отслеживайте статус через /api/payment_status каждые 30-60 секунд
Получите USDT на ваш кошелек после подтверждения (обычно 5-15 минут)
⚠️ Критически важно:
  • Переводите ТОЧНО указанную сумму
  • Заявка действует только 30 минут
  • Одна заявка = один перевод
  • Обязательно подтвердите оплату в боте
📱 Дополнительный функционал:

Вся история операций, баланс, реферальная программа и удобный интерфейс доступны в нашем Telegram боте @cardchange_bot

POST https://api.cardshoper.com/api/get_rate

💰 Получение актуального курса обмена

Получение текущего курса UAH/USDT и размера комиссии для вашего аккаунта

Запрос
Ответ
Пример
Параметры запроса
token string обязательно
API токен для авторизации клиента
Поля ответа
status string
Статус операции (success)
rate number
Текущий курс UAH/USDT (сколько гривен за 1 USDT)
commission_percent number
Процент комиссии для вашего аккаунта
currency_pair string
Валютная пара операции (UAH/USDT)
Коды ответов
200 Курс успешно получен
401 Недействительный токен
503 Курс временно недоступен
Пример запроса
POST https://api.cardshoper.com/api/get_rate Content-Type: application/json { "token": "your_api_token_here" }
Пример ответа
{ "status": "success", "rate": 41.5, "commission_percent": 12.0, "currency_pair": "UAH/USDT" }
POST https://api.cardshoper.com/api/get_card

🏦 Создание заявки и получение карты для оплаты

Создание новой заявки на обмен UAH → USDT и получение данных карты для оплаты

Запрос
Ответ
Пример
Параметры запроса
token string обязательно
API токен для авторизации клиента
amount number обязательно
Сумма к оплате в гривнах (UAH). Минимум: 100, максимум: 50000
Поля ответа
status string
Статус операции (success)
payment_id string
Уникальный идентификатор заявки (сохраните для отслеживания)
card_number string
Номер карты для перевода средств
amount number
Точная сумма к оплате в UAH
rate number
Зафиксированный курс обмена UAH/USDT
commission_percent number
Процент комиссии для данной операции
amount_to_receive number
Итоговая сумма к получению в USDT
Коды ответов
200 Заявка успешно создана
401 Недействительный токен
503 Сервис временно недоступен
Пример запроса
POST https://api.cardshoper.com/api/get_card Content-Type: application/json { "token": "your_api_token_here", "amount": 1000.0 }
Пример ответа
{ "status": "success", "payment_id": "ABC123DEF456", "card_number": "5168 7555 1234 5678", "amount": 1000.0, "rate": 41.5, "commission_percent": 12.0, "amount_to_receive": 21.20 }
POST https://api.cardshoper.com/api/payment_status

📊 Отслеживание статуса заявки

Получение актуального статуса заявки обмена по уникальному идентификатору

Запрос
Ответ
Пример
Статусы
Параметры запроса
token string обязательно
API токен для авторизации
payment_id string обязательно
Уникальный идентификатор заявки (получен из /api/get_card)
Поля ответа
status string
Статус запроса (success)
payment_id string
Идентификатор заявки
payment_status string
Текущий статус заявки
amount number
Сумма оплаты в UAH
amount_to_receive number
Сумма к получению в USDT
created_at string
Время создания заявки (UTC, ISO format)
expires_at string
Время истечения заявки (UTC, ISO format)
Коды ответов
200 Статус заявки получен
401 Недействительный токен
404 Заявка не найдена
Пример запроса
POST https://api.cardshoper.com/api/payment_status Content-Type: application/json { "token": "your_api_token_here", "payment_id": "ABC123DEF456" }
Пример ответа
{ "status": "success", "payment_id": "ABC123DEF456", "payment_status": "confirmed", "amount": 1000.0, "amount_to_receive": 21.20, "created_at": "2024-01-01T12:00:00", "expires_at": "2024-01-01T12:30:00" }
Возможные статусы заявок
created
🆕 Заявка создана, ожидает оплаты от клиента
waiting_payment_info
⏳ Ожидается подтверждение оплаты от клиента
confirmed
✅ Платеж подтвержден клиентом, проверяется оператором
completed
🎉 Обмен завершен успешно, USDT отправлены на кошелек
rejected
❌ Заявка отклонена (неверная сумма, поддельный чек и т.д.)
expired
⏰ Заявка истекла (прошло более 30 минут без оплаты)
POST https://api.cardshoper.com/api/get_history

📋 История операций

Получение истории всех операций пользователя с пагинацией и фильтрами

Запрос
Ответ
Пример
Параметры запроса
token string обязательно
API токен для авторизации
limit integer
Количество записей (по умолчанию: 50, максимум: 100)
offset integer
Смещение для пагинации (по умолчанию: 0)
status string
Фильтр по статусу (опционально)
Поля ответа
status string
Статус запроса (success)
total_count integer
Общее количество операций
operations array
Массив операций с подробной информацией
Пример запроса
POST https://api.cardshoper.com/api/get_history Content-Type: application/json { "token": "your_api_token", "limit": 10, "offset": 0, "status": "completed" }
Пример ответа
{ "status": "success", "total_count": 156, "operations": [ { "payment_id": "ABC123DEF456", "status": "completed", "amount": 1000.0, "amount_to_receive": 21.20, "rate": 41.5, "commission_percent": 12.0, "created_at": "2024-01-01T12:00:00Z", "completed_at": "2024-01-01T12:15:00Z" } ] }
POST https://api.cardshoper.com/api/set_webhook

🔔 Webhook уведомления

Настройка автоматических HTTP уведомлений о изменении статуса заявок

Настройка
Формат
Параметры запроса
token string обязательно
API токен для авторизации
webhook_url string обязательно
HTTPS URL для получения уведомлений
Пример запроса
POST /api/set_webhook Content-Type: application/json { "token": "your_api_token", "webhook_url": "https://your-site.com/webhook" }
Требования
HTTPS обязательно
🔒 HTTP URL не принимаются
Timeout: 10 секунд
⏱️ Ваш сервер должен ответить быстро
Статус ответа: 200 OK
✅ Для подтверждения получения
Формат уведомления
{ "payment_id": "ABC123DEF456", "status": "completed", "amount": 1000.0, "amount_to_receive": 21.20, "timestamp": "2024-01-01T12:30:00", "currency_from": "UAH", "currency_to": "USDT" }
Когда отправляются
confirmed
✅ Клиент подтвердил оплату
completed
🎉 Обмен завершен успешно
rejected
❌ Заявка отклонена
expired
⏰ Заявка истекла по времени

🧪 Тестовое API

Безопасная среда для разработки и отладки интеграции

POST https://api.cardshoper.com/api-test/get_rate

💰 Тестовое получение курса

Пример
POST /api-test/get_rate { "token": "your_api_token" } Ответ: { "status": "success", "rate": 40.0, "commission_percent": 10.0, "currency_pair": "UAH/USDT" }
POST https://api.cardshoper.com/api-test/get_card

🏦 Тестовое создание заявки

Пример
POST /api-test/get_card { "token": "your_api_token", "amount": 1000.0 } Ответ: { "status": "success", "payment_id": "TEST123DEF456", "card_number": "1111 2222 3333 4444", "amount": 1000.0, "rate": 40.0, "commission_percent": 10.0, "amount_to_receive": 22.5 }
POST https://api.cardshoper.com/api-test/payment_status

📊 Тестовая проверка статуса

Пример
POST /api-test/payment_status { "token": "your_api_token", "payment_id": "TESTAPI123456" } Ответ: { "status": "success", "payment_id": "TEST123DEF456", "payment_status": "completed", "amount": 1000.0, "amount_to_receive": 22.5, "created_at": "2024-01-01T12:00:00", "expires_at": "2024-01-01T12:30:00" }

📋 Особенности тестового API:

✅ Что работает:
  • Использует ваши обычные API токены
  • Полная имитация продакшн API
  • Тестовые курсы и данные
❌ Что НЕ работает:
  • НЕ создает реальные заявки
  • НЕ уведомляет операторов
  • НЕ отправляет webhook

Использование: Применяйте ваш обычный клиентский API токен для тестирования интеграции