اتصال 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>
- یک دکمهٔ «خرید پلن» (پایین-چپ) نشان میدهد؛ بعد از پرداخت، نام پلن و تاریخ پایانش را.
- وقتی کاربر از پرداخت برمیگردد،
hub_paymentرا از آدرس میخواند، نتیجه را از هاب میپرسد و پلن فعال را در مرورگر نگه میدارد. data-position="bottom-right"(یاtop-left، …) جای دکمه را عوض میکند.data-button="off"دکمه را برمیدارد تا دکمهٔ خودتان را بسازید.
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باید رویfront.bzیاwww.front.bzباشد؛ آدرس دیگر نادیده گرفته میشود و کاربر به خود front.bz برمیگردد.refرا URL-encode کنید. شناسهٔ داخلی کاربر کافی است؛ ایمیل یا شماره نفرستید.
پارامترهای برگشت
بعد از پرداخت، کاربر به return برمیگردد با:
| پارامتر | معنی |
|---|---|
hub_payment | کد پرداخت |
hub_status | paid یا failed |
hub_sig | HMAC_SHA256(secret, "<code>.<status>") بهصورت hex |
پارامترهای آدرس را کاربر میتواند دستکاری کند. قبل از فعال کردن پلن، یا
hub_sig را در سرور بررسی کنید یا وضعیت را از API بپرسید.تأیید پرداخت (هر کدام کافی است)
- پرسیدن با کد (عمومی، بدون کلید):
GET https://asarad.ai/api/hub/v1/payments/<code> → {status, plan, endsAt, active, ref} - اشتراک یک کاربر (با کلید، فقط از سرور):
GET https://asarad.ai/api/hub/v1/front/subscriptions?ref=<user-id> X-Hub-Key: <secret> → {active, payments[]} - وبهوک: آدرسش را به ما بدهید تا در پنل ثبت شود. برای هر پرداخت موفق:
اگر 2xx برنگردد، تا ۸ بار با فاصلهٔ فزاینده دوباره میفرستد. پاسخ را سریع بدهید و تکراری بودن را باPOST <webhook> X-Hub-Event: payment.paid X-Hub-Signature: sha256=<HMAC_SHA256(secret, raw body)> {"event":"payment.paid","payment":{...},"sentAt":"..."}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، در متغیر محیطی، نگه دارید؛ هرگز در کد فرانتاند، مخزن گیت یا پیامرسان نگذارید. اگر لو رفت خبر دهید تا عوض شود.
رفتار پلنها
- پلنها زماندار هستند: هر پرداخت پلن را برای
periodDaysروز فعال میکند (۳۰ = ماهانه، ۳۶۵ = سالانه). - پرداخت دوباره برای همان کاربر (
ref) به انتهای دورهٔ فعلی اضافه میشود. - لیست پلنها (عمومی):
GET https://asarad.ai/api/hub/v1/front/plans - تغییر قیمت روی پرداختهای قبلی اثری ندارد. غیرفعال شدن یک پلن فقط آن را از صفحهٔ پرداخت برمیدارد؛ دورههای پرداختشده ادامه دارند.
تا وقتی پلنها فعال نشدهاند، دکمهٔ «خرید پلن» نمایش داده نمیشود و لیست پلنها خالی است؛ این طبیعی است. بعد از جاگذاری اسکریپت خبر دهید تا پلنها فعال شوند و یک پرداخت آزمایشی انجام شود.