اتصال سایت شما به درگاه‌های رسمی

✓ درگاه رسمی بانکی ✓ اتصال با یک درخواست API
سه گام ساده

چطور شروع کنید؟

از درخواست کلید تا اولین پرداخت، مسیر کوتاه و شفاف است.

۱

درخواست کلید از پشتیبانی

در تلگرام به پشتیبانی پیام بدهید؛ پس از بررسی، کلید API اختصاصی شما در پنل مدیریت ساخته و تحویل داده می‌شود.

۲

اتصال با یک درخواست API

با یک درخواست POST مبلغ و آدرس بازگشت را بفرستید؛ نشانی صفحه پرداخت را تحویل بگیرید و کاربر را به آن هدایت کنید.

۳

دریافت پرداخت و گزارش

پس از پرداخت، کاربر به سایت شما برمی‌گردد، نتیجه با استعلام API تأیید می‌شود و تراکنش در گزارش سامانه ثبت می‌گردد.

مستندات فنی

اتصال با API — ساده و سریع

کلید API فقط از طریق پشتیبانی صادر می‌شود. با این کلید، ساخت پرداخت و استعلام وضعیت، هرکدام با یک درخواست انجام می‌شود.

POSThttps://example.com/api/pg/request
پارامترتوضیح
Authorizationهدر احراز هویت: Bearer pg_xxxx اجباری
amountمبلغ به تومان (عدد صحیح) — بین حداقل و حداکثر مجاز سامانه اجباری
callbackآدرس بازگشت کاربر پس از پرداخت (https) — اگر برای API شما آدرس ثابتی ثبت شده باشد، لازم نیست و مقدار ارسالی نادیده گرفته می‌شود
descriptionتوضیح دلخواه سفارش (اختیاری، حداکثر ۱۲۰ کاراکتر)
order_idشناسه سفارش خودتان (اختیاری، حداکثر ۴۰ کاراکتر)
پاسخ موفق شامل payment_url است؛ کاربر را به همین نشانی هدایت کنید. هر پرداخت بلافاصله یک فاکتور خودکار می‌گیرد: فیلد invoice_url در پاسخ درخواست و پس از پرداخت در پارامترهای بازگشت هم ارسال می‌شود. کاربر با پارامترهای tx_id، status، amount، ref به آدرس بازگشت شما برمی‌گردد (در پاسخ درخواست، فیلد callback آدرس مؤثر بازگشت را نشان می‌دهد) و نتیجه نهایی همیشه با استعلام وضعیت قابل تأیید است: GET /api/pg/status?tx=… شناسه تراکنش‌ها (tx_id) با پیشوند اختصاصی API شما ساخته می‌شوند — مثل BRAND_xxxxxxxxxx — که از پنل مدیریت قابل تنظیم است؛ صفحه اعتماد عمومی کسب‌وکار هم در نشانی /trust/{دامنه} در دسترس است.
// ساخت پرداخت
$ch = curl_init('https://example.com/api/pg/request');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => ['Content-Type: application/json',
                             'Authorization: Bearer pg_xxxxxxxxxxxx'],
  CURLOPT_POSTFIELDS     => json_encode([
    'amount'      => 150000,
    'callback'    => 'https://your-site.ir/pay/result',
    'order_id'    => '1024',
    'description' => 'سفارش ۱۰۲۴',
  ]),
]);
$res = json_decode(curl_exec($ch), true);
// هدایت کاربر به صفحه پرداخت
header('Location: ' . $res['payment_url']);
افزونهٔ آمادهٔ ووکامرس و وردپرس
بدون کدنویسی: نصب در وردپرس، فعال‌سازی در «ووکامرس → پرداخت‌ها» و وارد کردن کلید API؛ تأیید پرداخت با استعلام سمت سرور انجام می‌شود.
دانلود افزونه (.zip)
شفافیت کامل

مسیر یک پرداخت

پرداخت از طریق درگاه رسمی انجام می‌شود، نتیجه در سامانه ثبت می‌گردد و تسویه با پذیرنده توسط مدیر سامانه انجام و گزارش می‌شود.

مشتری شمادر سایت پذیرنده سفارش می‌دهد
درگاه رسمیدرگاه بانکی رسمی
ثبت در سامانهوریفای سمت سرور و ثبت در گزارش
تسویه پذیرندهتوسط مدیر سامانه، با گزارش دقیق
هیچ اطلاعات کارتی در این سامانه ذخیره نمی‌شود؛ پرداخت مستقیماً در درگاه رسمی انجام می‌گیرد.
چرا این سامانه؟

ابزارهایی برای آرامش خیال شما

درگاه‌های رسمی

پرداخت از طریق درگاه رسمی بانکی انجام می‌شود؛ بدون واسطه‌های غیرمجاز.

اتصال ساده

یک درخواست برای ساخت پرداخت، یک درخواست برای استعلام وضعیت — بدون پیچیدگی.

امنیت پرداخت

وریفای کامل سمت سرور با خود درگاه، جلوگیری از دستکاری مبلغ و تکرار تراکنش.

گزارش دقیق

هر تراکنش با مبلغ، وضعیت، فاکتور و زمان ثبت می‌شود؛ گزارش هر API جداگانه قابل دریافت است.

پشتیبانی واقعی

پاسخ‌گویی مستقیم در تلگرام؛ صدور کلید، اتصال و رفع مشکل با همان مسیر پشتیبانی انجام می‌شود.

تجربه پرداخت روان

صفحه پرداخت سبک و موبایل‌پسند؛ مشتری شما بدون سردرگمی به درگاه رسمی می‌رسد.

آماده اتصال هستید؟

به پشتیبانی پیام بدهید؛ کلید API شما ساخته می‌شود و طبق مستندات همین صفحه، چند دقیقه‌ای متصل شوید.