Legacy API v1

Authentication uses a settings query parameter containing a JSON object with your partner login and password. Passwords are validated using bcrypt hashing.

Аутентификация через query-параметр settings, содержащий JSON-объект с login и password партнёра. Пароли проверяются через bcrypt-хеширование.

GET /public/json/web.service.2024.php
  ?action=1
  &settings={"login":"your_login","password":"your_password","lang":"en"}

REST API v2

Uses JWT Bearer tokens. Obtain a token via the login endpoint, then include it in every request header.

Используются JWT Bearer токены. Получите токен через эндпоинт авторизации, затем передавайте его в заголовке запроса.

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Legacy API v1

Returns a JSON object with code and message. Code "0" means success. Any other code indicates an error.

Возвращает JSON с полями code и message. Код "0" — успех. Любой другой код — ошибка.

{
  "code": "0-3",
  "message": "PARTNER_INACTIVE"
}

Common Error Codes (prefix 0-X)

Общие коды ошибок (префикс 0-X)

REST API v2

Uses standard HTTP status codes with a JSON body containing success boolean and error message.

Использует стандартные HTTP коды с JSON-ответом, содержащим success (boolean) и error (сообщение).

{
  "success": false,
  "error": "Unauthorized: Invalid or expired token"
}

Request Format

Формат запроса

GET /public/json/web.service.2024.php
    ?action={1-6}
    &settings={"login":"...","password":"...","lang":"en","currency":"AZN"}
    &data={url_encoded_json}

GET  Action 1 — Get Products Получить продукты

Returns the catalog of available products accessible to the partner. Products are filtered by partner's access permissions.

Возвращает каталог доступных продуктов для партнёра. Продукты фильтруются по правам доступа партнёра.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=1" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode "lang=en"

{
  "code": "0",
  "message": "SUCCESS",
  "data": [
    {
      "productId": "42",
      "productName": "Xbox Game Pass Ultimate 1 Month",
      "imageUrl": "https://admin.pay.net.az/uploads/products/xbox-gp.png",
      "thumbnailUrl": "https://admin.pay.net.az/uploads/products/thumb/xbox-gp.png"
    },
    {
      "productId": "58",
      "productName": "Steam Wallet $50",
      "imageUrl": "https://admin.pay.net.az/uploads/products/steam-50.png",
      "thumbnailUrl": null
    }
  ]
}

GET  Action 2 — Get Packages Получить пакеты

Returns available packages for a specific product, with prices in the requested currency.

Возвращает доступные пакеты для конкретного продукта с ценами в запрошенной валюте.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=2" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode 'data={"product":"42"}' \
  --data-urlencode "currency=AZN"

{
  "code": "0",
  "message": "SUCCESS",
  "data": [
    {
      "packageId": "101",
      "packageName": "Xbox Game Pass Ultimate 1 Month (TR)",
      "packagePrice": "25.50",
      "currency": "AZN"
    }
  ]
}

GET  Action 3 — Reserve Key Зарезервировать ключ

Reserves a digital key from a package. The key is locked for 10 minutes. Must be confirmed (Action 4) or cancelled (Action 5) within this time.

Резервирует цифровой ключ из пакета. Ключ блокируется на 10 минут. Необходимо подтвердить (Action 4) или отменить (Action 5) в течение этого времени.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=3" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode 'data={"package":"101"}' \
  --data-urlencode "currency=AZN"

{
  "code": "0",
  "message": "SUCCESS",
  "data": {
    "keyId": "8847",
    "keyText": "XXXX-YYYY-ZZZZ-WWWW",
    "serialNumber": "SN-12345",
    "price": "25.50",
    "currency": "AZN"
  }
}

GET  Action 4 — Confirm Sale Подтвердить продажу

Confirms the purchase of a previously reserved key. Creates an order record and marks the key as sold. The package auto-deactivates if this was the last key.

Подтверждает покупку зарезервированного ключа. Создаёт запись заказа и помечает ключ как проданный. Пакет автоматически деактивируется если это был последний ключ.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=4" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode 'data={"key":"8847","order":"PAY-2026-001","currency":"AZN"}'

{
  "code": "0",
  "message": "SUCCESS"
}

GET  Action 5 — Cancel Reservation Отменить резервацию

Cancels a previously reserved key, returning it to the available pool.

Отменяет резервацию ключа, возвращая его в доступные.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=5" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode 'data={"key":"8847"}'

{
  "code": "0",
  "message": "SUCCESS"
}

GET  Action 6 — Direct Purchase (One-Step) Прямая покупка (один шаг)

Combines reservation and confirmation in a single call. Optionally sends the key to the customer via email with activation instructions. Auto-deactivates the package when the last key is sold.

Объединяет резервацию и подтверждение в одном вызове. Опционально отправляет ключ клиенту по email с инструкцией активации. Автоматически деактивирует пакет при продаже последнего ключа.

curl -G "https://admin.pay.net.az/public/json/web.service.2024.php" \
  --data-urlencode "action=6" \
  --data-urlencode 'settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"en"}' \
  --data-urlencode 'data={"package":"101","order":"PAY-2026-002","email":"customer@example.com","lang":"en"}' \
  --data-urlencode "currency=AZN"

{
  "code": "0",
  "message": "SUCCESS",
  "data": {
    "keyId": "8848",
    "keyText": "AAAA-BBBB-CCCC-DDDD",
    "serialNumber": "SN-67890"
  }
}

Standard Flow (Two-Step)

Стандартный поток (два шага)

For payment terminals that need to show the price before charging the customer.

Для платёжных терминалов, которым нужно показать цену до списания средств.

Express Flow (One-Step)

Экспресс-поток (один шаг)

For online stores where payment is already completed.

Для интернет-магазинов, где оплата уже произведена.

Response Format

Формат ответа

{
  "success": true,
  "data": { ... },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 148,
    "totalPages": 8
  }
}

Authentication Аутентификация

{
  "login": "admin",
  "password": "your_password"
}

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGci...",
    "refreshToken": "eyJhbGci...",
    "user": {
      "id": 1,
      "login": "admin",
      "role": "super_admin"
    }
  }
}

{ "refreshToken": "eyJhbGci..." }

Products Продукты

curl "https://admin.pay.net.az/api/products?page=1&limit=10&status=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "name_en": "Steam Wallet $20",
  "name_ru": "Steam Кошелёк $20",
  "name_az": "Steam Cüzdan $20",
  "vendor_id": 5,
  "subcategory_id": 12,
  "status": 1,
  "position": 10
}

Packages Пакеты

{
  "name_en": "Steam $20 Global",
  "product_id": 42,
  "supplier_id": 3,
  "price": 34.00,
  "currency": "AZN",
  "status": 1
}

Keys Ключи

{
  "package_id": 101,
  "key_text": "XXXX-YYYY-ZZZZ-WWWW",
  "serial_number": "SN-12345",
  "expires_at": "2027-12-31"
}

{
  "package_id": 101,
  "keys": [
    { "key_text": "KEY-001", "serial_number": "SN-001" },
    { "key_text": "KEY-002", "serial_number": "SN-002" },
    { "key_text": "KEY-003" }
  ]
}

{ "ids": [100, 101, 102] }

Orders Заказы

{ "status": "cancelled" }

Partners Партнёры

{
  "product_ids": [42, 58, 73],
  "all_products": false
}

{
  "name": "PayNet Azerbaijan",
  "login": "paynet",
  "password": "secure_password",
  "api_key": "unique-api-key-string",
  "status": 1,
  "default_currency": "AZN"
}

Suppliers (Vendors) Поставщики (Вендоры)

{
  "name": "Digital Keys Supplier",
  "country": "Turkey",
  "contact_email": "sales@supplier.com",
  "status": 1
}

When you include the email parameter in Action 6, KeyForge automatically sends a beautifully formatted email to the customer containing:

Когда вы включаете параметр email в Action 6, KeyForge автоматически отправляет красиво оформленное письмо клиенту, содержащее:

• Product name and image
• Название и изображение продукта
• Digital key (PIN code)
• Цифровой ключ (PIN-код)
• Serial number (if applicable)
• Серийный номер (если есть)
• Product-specific activation instructions
• Инструкции по активации для конкретного продукта
• Partner branding (logo, support email)
• Брендинг партнёра (логотип, email поддержки)

// Send key + email to customer in Russian
GET /public/json/web.service.2024.php
  ?action=6
  &settings={"login":"YOUR_LOGIN","password":"YOUR_PASSWORD","lang":"ru"}
  &data={"package":"101","order":"ORD-001","email":"user@mail.com","lang":"ru"}

KeyForge processes webhook events from Resend to track email delivery status. Supported events:

KeyForge обрабатывает вебхук-события от Resend для отслеживания статуса доставки. Поддерживаемые события: