Tərtibatçılar

Canlı Sistem Vəziyyəti və Metriklər

Bütün Sistemlər İşləkdir

Aylıq Uptime99.98%

API Əsas URLgateway.pratikpay.pro

Köçürmə / FAST ŞəbəkəsiAktivdir

9 Rəqəmsal Pul KisəsiAktivdir

İdentifikasiya başlıqları

x-api-key	API açarınız.
x-timestamp	Sorğunun göndərildiyi vaxt (unix saniyəsi).
x-nonce	Təkrar istifadəsiz təsadüfi dəyər.
x-signature	Sorğu gövdəsinin HMAC-SHA256 imzası (hex).

Content-Type: application/json

Məcburi gövdə sahələri

api_key
payment_method
full_name
username
amount
currency
site_user_id
site_transaction_id
callback_url
return_url

Məzmun növü: application/json

İmzanın yaradılması

1Gövdədən hash və secret_key sahələrini çıxarın.
2Qalan açarları əlifba sırası ilə düzün.
3Sıralı obyekti JSON.stringify ilə mətnə çevirin.
4Secret key ilə HMAC-SHA256 hesablayın; hex nəticəni x-signature başlığına əlavə edin.

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");

Uclar

POST
/api/service/v1/deposit/create
Depozit tələbi açır.
POST
/api/service/v1/deposit/check
Depozit vəziyyətini sorğulayır.
POST
/api/service/v1/withdrawal/create
Çıxarış tələbi açır.
POST
/api/service/v1/withdrawal/check
Çıxarış vəziyyətini sorğulayır.
POST
/api/service/v1/company/balance
Balans və hesabatı sorğulayır.

Nümunə sorğu — 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"
  }'

Nümunə cavab

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
  }
}

Callback

Nəticə, depozit açılışında verilən callback_url ünvanına POST edilir və X-Callback-Signature başlığı ilə imzalanır; eyni HMAC üsulu ilə yoxlanılır.

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"
}