Разработчикам

Текущий статус системы и метрики

Все системы работают

Uptime за месяц99.98%

Базовый URL APIgateway.pratikpay.pro

Сеть переводов / FASTАктивно

9 цифровых кошельковАктивно

Заголовки авторизации

x-api-key	Ваш API-ключ.
x-timestamp	Время отправки запроса (unix-секунды).
x-nonce	Одноразовое случайное значение.
x-signature	Подпись HMAC-SHA256 тела запроса (hex).

Content-Type: application/json

Обязательные поля тела

api_key
payment_method
full_name
username
amount
currency
site_user_id
site_transaction_id
callback_url
return_url

Тип содержимого: application/json

Генерация подписи

1Удалите из тела поля hash и secret_key.
2Отсортируйте остальные ключи по алфавиту.
3Сериализуйте объект через JSON.stringify.
4Вычислите HMAC-SHA256 с секретным ключом; hex-результат — в заголовок x-signature.

Node.js

import crypto from "node:crypto";

const sorted = {};
for (const key of Object.keys(body).sort()) {
  sorted[key] = body[key];
}

const signature = crypto
  .createHmac("sha256", SECRET_KEY)
  .update(JSON.stringify(sorted))
  .digest("hex");

Эндпоинты

POST
/api/service/v1/deposit/create
Открывает запрос на депозит.
POST
/api/service/v1/deposit/check
Запрашивает статус депозита.
POST
/api/service/v1/withdrawal/create
Открывает запрос на вывод.
POST
/api/service/v1/withdrawal/check
Запрашивает статус вывода.
POST
/api/service/v1/company/balance
Запрашивает баланс и отчёт компании.

Пример запроса — deposit/create

BASE_URL="https://gateway.pratikpay.pro"

curl -X POST "$BASE_URL/api/service/v1/deposit/create" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-timestamp: 1790000000" \
  -H "x-nonce: 7f3a9c1e4b8a2c1d" \
  -H "x-signature: 4a2b9d8e7c1f..." \
  -d '{
    "api_key": "your_api_key",
    "payment_method": 0,
    "full_name": "Ahmet Yılmaz",
    "username": "ahmetyilmaz",
    "amount": 150,
    "currency": "TL",
    "site_user_id": "usr_12345",
    "site_transaction_id": "inv_1704102000_98765",
    "callback_url": "https://yoursite.com/api/callback",
    "return_url": "https://yoursite.com/payment/success",
    "theme": 0,
    "language": "auto"
  }'

Пример ответа

JSON

{
  "success": true,
  "message": "Ödeme sayfası başarıyla oluşturuldu",
  "data": {
    "payment_id": "b1a2c3d4-e5f6-7890-1234-567890abcdef",
    "redirect_link": "https://pay.pratikpay.pro/payment/session_token...",
    "amount": 150,
    "currency": "TL",
    "payment_method": 0
  }
}

Колбэк

Результат отправляется POST на callback_url, указанный при создании депозита, с заголовком X-Callback-Signature; проверяется той же схемой HMAC.

HTTP / JSON

POST <callback_url>
Content-Type: application/json
X-Callback-Signature: <hex>

{
  "transaction_type": "deposit",
  "id": "b1a2c3d4-e5f6-7890-1234-567890abcdef",
  "site_user_id": "usr_12345",
  "site_transaction_id": "inv_1704102000_98765",
  "username": "ahmetyilmaz",
  "amount": 150,
  "currency": "TL",
  "status": "confirmed",
  "status_code": 1,
  "payment_method": 0,
  "payment_method_string": "havale",
  "is_modified": false,
  "is_test": false,
  "created_at": "2026-01-01T12:00:00.000Z"
}