اتصال front.bz به هاب فروش asarad.ai

پلن‌ها و قیمت‌های front.bz در asarad.ai تعریف می‌شوند. کاربر بدون لاگین در asarad.ai پلن را می‌خرد (درگاه جیبیت) و به front.bz برمی‌گردد. کار شما فقط این است که کاربر را به صفحهٔ پرداخت بفرستید و نتیجه را بخوانید.

شناسهٔ سرویسfront صفحهٔ پرداختhttps://asarad.ai/pay/front اسکریپتhttps://asarad.ai/hub.js APIhttps://asarad.ai/api/hub/v1/…

روش ۱ — یک خط، برای سایت استاتیک (بدون بک‌اند)

در <head> فایل index.html بگذارید:

<script src="https://asarad.ai/hub.js" data-merchant="front" defer></script>

API داخل صفحه

AsaHub.active()        // null یا {code, plan, planTitle, startsAt, endsAt, ref}
AsaHub.open('yearly')  // رفتن به صفحهٔ پرداخت؛ کد پلن اختیاری است
AsaHub.ref()           // شناسهٔ کاربر در این مرورگر
window.addEventListener('asahub:change', e => {
  // e.detail = پلن فعال یا null
});

نمونهٔ دکمهٔ اختصاصی:

<button onclick="AsaHub.open('monthly')">خرید پلن ماهانه</button>
در این روش، شناسهٔ کاربر یک شناسهٔ تصادفی در همان مرورگر است. اگر کاربر حساب دارد، روش ۲ را ببینید تا پلن به حسابش وصل شود نه به مرورگر.

روش ۲ — کاربر با حساب (بک‌اند front.bz)

کاربر را با شناسهٔ خودش به صفحهٔ پرداخت بفرستید:

https://asarad.ai/pay/front?ref=<user-id>&return=<URL on front.bz>&plan=<plan code, optional>

پارامترهای برگشت

بعد از پرداخت، کاربر به return برمی‌گردد با:

پارامترمعنی
hub_paymentکد پرداخت
hub_statuspaid یا failed
hub_sigHMAC_SHA256(secret, "<code>.<status>") به‌صورت hex
پارامترهای آدرس را کاربر می‌تواند دست‌کاری کند. قبل از فعال کردن پلن، یا hub_sig را در سرور بررسی کنید یا وضعیت را از API بپرسید.

تأیید پرداخت (هر کدام کافی است)

  1. پرسیدن با کد (عمومی، بدون کلید):
    GET https://asarad.ai/api/hub/v1/payments/<code>
    → {status, plan, endsAt, active, ref}
  2. اشتراک یک کاربر (با کلید، فقط از سرور):
    GET https://asarad.ai/api/hub/v1/front/subscriptions?ref=<user-id>
    X-Hub-Key: <secret>
    → {active, payments[]}
  3. وب‌هوک: آدرسش را به ما بدهید تا در پنل ثبت شود. برای هر پرداخت موفق:
    POST <webhook>
    X-Hub-Event: payment.paid
    X-Hub-Signature: sha256=<HMAC_SHA256(secret, raw body)>
    
    {"event":"payment.paid","payment":{...},"sentAt":"..."}
    اگر 2xx برنگردد، تا ۸ بار با فاصلهٔ فزاینده دوباره می‌فرستد. پاسخ را سریع بدهید و تکراری بودن را با payment.code تشخیص دهید.

نمونهٔ بررسی امضا (Node.js)

import crypto from "node:crypto";
const SECRET = process.env.ASARAD_HUB_SECRET;
const hmac = (s) => crypto.createHmac("sha256", SECRET).update(s).digest("hex");
const same = (a, b) => a.length === b.length && crypto.timingSafeEqual(Buffer.from(a), Buffer.from(b));

// return URL
const okReturn = same(hmac(`${code}.${status}`), sig);

// webhook (rawBody = exact request bytes, before JSON.parse)
const okHook = same("sha256=" + hmac(rawBody), req.headers["x-hub-signature"]);

کلید امضا (secret)

کلید را جدا (نه در این صفحه) از مدیر asarad.ai بگیرید. فقط روی سرور front.bz، در متغیر محیطی، نگه دارید؛ هرگز در کد فرانت‌اند، مخزن گیت یا پیام‌رسان نگذارید. اگر لو رفت خبر دهید تا عوض شود.

رفتار پلن‌ها

تا وقتی پلن‌ها فعال نشده‌اند، دکمهٔ «خرید پلن» نمایش داده نمی‌شود و لیست پلن‌ها خالی است؛ این طبیعی است. بعد از جاگذاری اسکریپت خبر دهید تا پلن‌ها فعال شوند و یک پرداخت آزمایشی انجام شود.