اتصال به درگاه (API)

اگر ربات یا سایتِ فروش دارید، با همین سه اندپوینت، پرداخت‌هایتان از این درگاه انجام می‌شود و پول در حساب خودتان ثبت می‌شود. نیازی به تغییرِ منطقِ پرداخت نیست؛ فقط آدرسِ سرویس و کلید را عوض کنید.

آدرس و کلید

آدرس پایه	`https://pay.polgram.nls2026h.xyz`
احراز هویت	`Authorization: Bearer <YOUR_API_KEY>`
دریافت کلید	از داخل همین ربات — دکمه‌ی «🔗 اتصال درگاه (API)»
حد مبلغ	10,000 تا 1,000,000 تومان

۱) ساخت فاکتور

POST https://pay.polgram.nls2026h.xyz/pay/create-order.php

{
  "order_id": "MY-1042",
  "price_amount": 125000
}

پاسخ:

{
  "success": true,
  "order_id": "MY-1042",
  "authority": "...",
  "pay_page_url": "https://pay.polgram.nls2026h.xyz/paypage/...",
  "pay_amount_toman": 125081,
  "expires_in_minutes": 30,
  "show_card_in_bot": true,
  "card": {"number": "...", "holder": "...", "bank": ""},
  "status": "pending"
}

ساختِ فاکتور چیزی از موجودیِ شما کم نمی‌کند و به موجودی هم اضافه نمی‌کند؛ فقط فاکتور ثبت می‌شود. مبلغِ قابلِ واریز (pay_amount_toman) با مبلغِ درخواستیِ کمی فرق دارد — همان عدد را به خریدار بدهید.

۲) استعلام وضعیت

GET https://pay.polgram.nls2026h.xyz/pay/check-order-status.php?order_id=MY-1042

پاسخ: success، status یکی از pending/paid/expired، و status_code برابر 0 / 100 / 101. وقتی پرداخت شد، paid_at و amount هم می‌آید.

۳) تایید نهایی

POST https://pay.polgram.nls2026h.xyz/smspay/api/verify-payment.php

{
  "authority": "..."
}

پاسخ موفق: status: "verified" و status_code: 100. تکرارِ همان درخواست بی‌خطر است و چیزی را دوباره حساب نمی‌کند. اگر هنوز واریزی نیامده status_code: 0 و اگر مهلت تمام شده status_code: 101.

قاعده‌ها

شناسه‌ی سفارش (order_id) فقط حروفِ انگلیسی، عدد، نقطه و خطِ زیر باشد؛ حداکثر ۶۴ نویسه.
تکرارِ همان شناسه در ساختِ فاکتور، همان فاکتورِ قبلی را برمی‌گرداند؛ شناسهٔ تکراری فاکتورِ دوم نمی‌سازد.
فقط پس از اینکه پول واقعاً واریز شد، تایید بزنید. وضعیت همیشه از سمتِ درگاه بررسی می‌شود؛ عدد را دستی «پرداخت‌شده» نکنید.
هر کلید فقط سفارش‌های خودش را می‌بیند و تایید می‌زند.

نمونه‌ی فراخوانی

curl -X POST https://pay.polgram.nls2026h.xyz/pay/create-order.php \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"MY-1042","price_amount":125000}'

ربات‌های آماده

اگر رباتِ شما «ساخت فاکتور / استعلام / تایید با توکن» دارد (بیشترِ ربات‌های فروشِ تلگرامی همین‌طورند):

توکنِ درگاه را در پنلِ رباتِ خود، همین کلیدتان را بگذارید؛
آدرسِ سرویسِ درگاه را با https://pay.polgram.nls2026h.xyz عوض کنید — معمولاً سه خطِ اندپوینت در فایلِ پرداخت یا یک فایلِ پیکربندی.

بقیه‌ی کارِ ربات (کارت، اطلاع‌رسانی، اعتبارِ کاربر) دست‌نخورده می‌ماند.

تست سلامت

GET https://pay.polgram.nls2026h.xyz/healthz باید {"ok": true} برگرداند.

کارمزد

کارمزدِ هر پرداخت از مبلغِ فروش کم می‌شود و مبلغِ خالص به موجودیِ شما می‌نشیند. نرخ را در پنلِ همین ربات می‌بینید؛ برداشتِ ارز دیجیتال در حالتِ پرمیوم انجام می‌شود.