مستندات API درگاه پرداخت

اعتبارسنجی

تمام درخواست‌ها باید شامل هدرهای کلید API باشند:

X-API-KEY: pk_********
X-API-SECRET: sk_********

ساخت فاکتور

پارامترهای Body (JSON)

پاسخ‌ها

پاسخ موفق (HTTP 201)

{
  "success": true,
  "status": 201,
  "data": {
    "authority": "INV_6a5d52c268309",
    "payment_url": "https://example.com/bot2/pay.html?id=INV_6a5d52c268309",
    "amount": 500000,
    "payable": 502500,
    "fee_amount": 2500,
    "net_amount": 500000,
    "gateway_type": "pool",
    "status": "awaiting_payment"
  }
}

پاسخ خطا (HTTP 401)

{
  "success": false,
  "status": 401,
  "message": "اعتبارسنجی کلید API ناموفق بود."
}

وب‌هوک (Callback)

پس از تایید پرداخت (خودکار یا دستی)، اگر callback_url تنظیم شده باشد، یک درخواست POST به آن آدرس ارسال می‌شود:

{
  "status": 1,
  "invoice_id": "INV_6a5d52c268309",
  "amount": 502500
}

کدهای خطا

مثال کامل (PHP)

<?php
 $data = [
    'amount' => 500000,
    'gateway_type' => 'pool',
    'callback_url' => 'https://yoursite.com/verify.php'
];

 $ch = curl_init('https://example.com/bot2/v1.php?action=api_request_invoice');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-KEY: pk_********',
    'X-API-SECRET: sk_********'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

 $response = curl_exec($ch);
 $result = json_decode($response, true);

if ($result['success']) {
    // هدایت کاربر به صفحه پرداخت
    header('Location: ' . $result['data']['payment_url']);
    exit;
} else {
    echo 'خطا: ' . $result['message'];
}

مثال کامل (cURL)

curl -X POST "https://example.com/bot2/v1.php?action=api_request_invoice" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: pk_********" \
  -H "X-API-SECRET: sk_********" \
  -d '{"amount": 100000, "callback_url": "https://yoursite.com/callback"}'