Geliştiriciler

Canlı Sistem Durumu & Metrikler

Tüm Sistemler Operasyonel

Aylık Uptime99.98%

API Base URLgateway.pratikpay.pro

Havale / FAST AğıAktif & İzleniyor

9 Dijital CüzdanAktif & İzleniyor

Kimlik başlıkları

x-api-key	Firmanıza özel API anahtarı.
x-timestamp	İsteğin gönderildiği zaman (unix saniyesi).
x-nonce	Tek kullanımlık rastgele değer.
x-signature	İstek gövdesinin HMAC-SHA256 imzası (hex).

Content-Type: application/json

Zorunlu gövde alanları

api_key
payment_method
full_name
username
amount
currency
site_user_id
site_transaction_id
callback_url
return_url

İçerik: application/json

İmza üretimi

1Gövdeden hash ve secret_key alanlarını çıkarın.
2Kalan anahtarları alfabetik olarak sıralayın.
3Sıralı nesneyi JSON.stringify ile metne çevir.
4HMAC-SHA256'yı secret key ile hesapla; hex sonucu x-signature başlığına ekle.

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

Uçlar

POST
/api/service/v1/deposit/create
Yatırım talebi açar.
POST
/api/service/v1/deposit/check
Yatırım durumunu sorgular.
POST
/api/service/v1/withdrawal/create
Çekim talebi açar.
POST
/api/service/v1/withdrawal/check
Çekim durumunu sorgular.
POST
/api/service/v1/company/balance
Bakiye ve mutabakat sorgular.

Örnek istek — 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"
  }'

Örnek yanıt

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

İşlem sonucu, yatırım açılırken verilen callback_url adresine POST edilir ve X-Callback-Signature başlığı ile imzalanır; aynı HMAC yöntemiyle doğrulanı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"
}