مستندات API — TetraPay

وارد پنل فروشنده شوید (منوی «اطلاعات API») و مقدار ApiKey خود را بردارید. APIهای زیر با همین کلید کار می‌کنند.

URL کامل: POST https://tetra98.ir/api/create_order

{
  "ApiKey": "YOUR_API_KEY",
  "Hash_id": "INV-10045",
  "Amount": 1000000,
  "Description": "خرید محصول A",
  "Email": "user@example.com",
  "Mobile": "09120000000",
  "CallbackURL": "https://merchant.example.com/callback"
}

{
  "status": "100",
  "Authority": "HS88JEPGGBWUZMHB",
  "payment_url_bot": "https://t.me/Tetra98_bot?start=pay_HS88JEPGGBWUZMHB",
  "payment_url_web": "https://tetra98.ir/payment/HS88JEPGGBWUZMHB",
  "tracking_id": "GPN2QE6B"
}

curl -X POST https://tetra98.ir/api/create_order \
  -H "Content-Type: application/json" \
  -d '{
    "ApiKey":"YOUR_API_KEY",
    "Hash_id":"INV-10045",
    "Amount":1000000,
    "CallbackURL":"https://merchant.example.com/callback"
  }'

$ch = curl_init("https://tetra98.ir/api/create_order");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    "ApiKey"=>"YOUR_API_KEY",
    "Hash_id"=>"INV-10045",
    "Amount"=>1000000,
    "CallbackURL"=>"https://merchant.example.com/callback"
  ])
]);
$resp = curl_exec($ch); curl_close($ch);
echo $resp;

fetch('https://tetra98.ir/api/create_order',{
  method:'POST',
  headers:{'Content-Type':'application/json'},
  body: JSON.stringify({
    ApiKey:'YOUR_API_KEY',
    Hash_id:'INV-10045',
    Amount:1000000,
    CallbackURL:'https://merchant.example.com/callback'
  })
}).then(r=>r.json()).then(console.log);

import requests, json
r = requests.post('https://tetra98.ir/api/create_order',
  headers={'Content-Type':'application/json'},
  data=json.dumps({
    'ApiKey':'YOUR_API_KEY',
    'Hash_id':'INV-10045',
    'Amount':1000000,
    'CallbackURL':'https://merchant.example.com/callback'
  })
)
print(r.status_code, r.text)

پس از دریافت پاسخ ایجاد سفارش، کاربر را به یکی از لینک‌های زیر هدایت کنید:

• درگاه پرداخت کارت به کارت: GET https://tetra98.ir/payment/{Authority}
• تلگرام: GET https://t.me/Tetra98_bot?start=pay_{Authority}

پس از تایید موفق (خودکار/دستی) به CallbackURL فروشنده ارسال ( POST )می‌شود:

POST {CallbackURL}
Content-Type: application/json

{
  "status": 100,
  "hashid": "{hashid}",
  "authority": "{authority}"
}

URL : POST https://tetra98.ir/api/verify

برای استفاده از این قسمت ارسال یکی از دو مورد authority و یا hashid الزامی و کافی است
* پیشنهاد ما استفاده از authority هست بدلیل یکتا بودن در پایگاه داده ما

نمونه کد :

{
  "ApiKey": "YOUR_API_KEY",
  "authority": "HS88JEPGGBWUZMHB"
}

و یا :

{
  "ApiKey": "YOUR_API_KEY",
  "hashid": "test1234"
}

موفق :

HTTP/1.1 200 (OK) 
{
    "status": 100,
    "hash_id": "test123456",
    "authority": "L45HSZ9RG5687JXH"
}

HTTP/1.1 400 Error / 404 Error
{
    "status": -1,
    "message": "توضیحات خطا"
}

curl -X POST https://tetra98.ir/api/verify \
  -H "Content-Type: application/json" \
  -d '{"ApiKey":"YOUR_API_KEY","authority":"HS88JEPGGBWUZMHB"}'

$ch = curl_init("https://tetra98.ir/api/verify");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    "ApiKey"=>"YOUR_API_KEY",
    "authority"=>"HS88JEPGGBWUZMHB"
  ])
]);
$resp = curl_exec($ch); curl_close($ch);
echo $resp;

fetch('https://tetra98.ir/api/verify',{
  method:'POST',
  headers:{'Content-Type':'application/json'},
  body: JSON.stringify({
    ApiKey:'YOUR_API_KEY',
    authority:'HS88JEPGGBWUZMHB'
  })
}).then(r=>console.log(r.status)).then(()=>{});

import requests, json
r = requests.post('https://tetra98.ir/api/verify',
  headers={'Content-Type':'application/json'},
  data=json.dumps({'ApiKey':'YOUR_API_KEY','authority':'HS88JEPGGBWUZMHB'})
)
print(r.status_code, r.text)