بلاگ · پرداخت
راهنمای کامل FiuraPay برای توسعهدهندگان و کسبوکارها؛ آشنایی با ساخت Invoice، پرداخت USDT، ETH، BNB و TRX، پرداخت تومانی، API، Webhook، امنیت و روشهای اتصال.

رمزارز را به محصولت اضافه کن؛ بدون اینکه مجبور باشی یک سیستم پرداخت بلاکچینی از صفر بسازی.
توسعهدهندهٔ کسبوکار معمولاً متخصص بلاکچین نیست. کار اصلی او این است که محصول، سبد خرید، ربات فروش یا بکاند SaaS را زنده نگه دارد.
وقتی یک مشتری میگوید «رمزارز هم قبول کنید»، مسئلهٔ واقعی این نیست که کدام کیف پول بهتر است.
سؤالهای مهمتر اینها هستند:
فاکتور از کجا ساخته شود؟ پول چه زمانی تأیید شود؟ و سفارش دقیقاً چه زمانی پرداختشده محسوب شود؟
اینجاست که Fiura وارد میشود.
Fiura یک درگاه پرداخت رمزارزی برای کسبوکارها و تیمهای فنی است؛ زیرساختی که ساخت فاکتور، صفحهٔ پرداخت، تشخیص تراکنش و اطلاعرسانی وضعیت پرداخت را در اختیار محصول قرار میدهد.
تو محصول را میسازی؛ Fiura جریان پرداخت را مدیریت میکند.
برای اضافه کردن پرداخت رمزارزی، قرار نیست تیم محصول یک پروتکل جدید یاد بگیرد یا یک نود بلاکچین راهاندازی کند.
یک integration ساده کافی است:
API Key → ساخت Invoice → دریافت Checkout URL → پرداخت مشتری → تأیید تراکنش → Webhook
در عمل، بکاند یا ربات تو یک فاکتور ایجاد میکند و اطلاعاتی مانند این موارد را مشخص میکند:
externalIdFiura در پاسخ، لینک صفحهٔ پرداخت را در اختیار سیستم قرار میدهد.
همان لینک میتواند در سایت، اپلیکیشن، ربات، ایمیل یا هر کانال دیگری که مشتری از آن خرید میکند استفاده شود.
پرداخت رمزارزی فقط به یک بلاکچین محدود نیست.
در Fiura میتوانی بسته به نیاز کسبوکارت شبکهٔ مناسب را انتخاب کنی.
برای پرداختهایی که سرعت و هزینهٔ پایین تراکنش اهمیت دارد، BSC میتواند گزینهٔ مناسبی باشد.
برای کسبوکارهایی که میخواهند در بزرگترین اکوسیستم EVM حضور داشته باشند، Ethereum انتخاب طبیعیتری است.
برای پرداختهای مبتنی بر USDT، بهخصوص در سناریوهایی که حجم بالای پرداخت مطرح است، TRON یکی از گزینههای مهم است.
نکته اینجاست که منطق کسبوکار تو با تغییر شبکه عوض نمیشود.
Invoice همان Invoice است؛ فقط شبکهٔ پرداخت تغییر میکند.
در جریان پرداخت، کسبوکار میتواند مبلغ را بر اساس نیاز خود تعریف کند.
مثلاً میتوانی قیمت محصول را به تومان مشخص کنی و Fiura مقدار رمزارز موردنیاز را محاسبه کند؛ یا مستقیماً مبلغ را بر اساس یک دارایی مانند USDT تعیین کنی.
مشتری نیز از کیف پول خودش پرداخت میکند.
بسته به جریان پرداخت، روشهایی مانند:
txHashمیتوانند در اختیار کاربر قرار بگیرند.
در نتیجه، مشتری لازم نیست برای پرداخت وارد چند سایت مختلف شود یا برای پیدا کردن تراکنش، چند Explorer را باز کند.
یکی از بخشهای مهم هر درگاه پرداخت، خود صفحهٔ Checkout است.
اگر این مرحله پیچیده باشد، حتی بهترین API هم نمیتواند تجربهٔ پرداخت خوبی ایجاد کند.
Fiura این بخش را آماده میکند تا مشتری بتواند اطلاعات مهم پرداخت را در یک محیط مشخص ببیند:
به این ترتیب، کسبوکار لازم نیست خودش یک Payment UI کامل برای تراکنشهای بلاکچینی طراحی کند.
جریان اصلی پرداخت را میتوان خیلی ساده تصور کرد:
۱. ایجاد Invoice
بکاند، ربات یا سیستم اتوماسیون تو یک Invoice ایجاد میکند.
۲. دریافت Checkout URL
Fiura لینک پرداخت را برمیگرداند.
۳. پرداخت مشتری
مشتری از کیف پول خودش پرداخت را انجام میدهد.
۴. تشخیص تراکنش
پرداخت روی شبکه شناسایی میشود.
۵. تغییر وضعیت Invoice
پس از تأیید شرایط پرداخت، وضعیت Invoice به paid تغییر میکند.
۶. ارسال Webhook
Fiura نتیجه را به endpoint تعریفشده توسط کسبوکار ارسال میکند.
۷. انجام عملیات نهایی
از اینجا سیستم تو میتواند سفارش را تحویل دهد، لایسنس را فعال کند، اعتبار حساب را افزایش دهد یا هر فرآیند دیگری را اجرا کند.
یعنی توسعهدهنده دیگر لازم نیست هر چند دقیقه بلاکچین را بررسی کند تا بفهمد مشتری پول را فرستاده یا نه.
برای یک سیستم پرداخت واقعی، فقط تشخیص تراکنش کافی نیست.
سیستم فروش باید بداند چه زمانی پرداخت تأیید شده است.
Webhook این ارتباط را برقرار میکند.
وقتی وضعیت پرداخت تغییر میکند، Fiura اطلاعات مربوط به پرداخت را به آدرسی که کسبوکار تعریف کرده ارسال میکند.
این یعنی میتوانی جریانهایی مثل این بسازی:
Fiura → Webhook → Backend → Order Paid → Deliver Product
یا:
Fiura → Webhook → n8n → Telegram / Discord / CRM
برای امنیت بیشتر، Webhook را میتوان با امضای HMAC اعتبارسنجی کرد تا سیستم تو بتواند تشخیص دهد درخواست واقعاً از منبع مورداعتماد آمده است.
این موضوع در زیرساختهای پرداخت اهمیت زیادی دارد؛ چون یک Webhook جعلی نباید بتواند یک سفارش را به وضعیت «پرداختشده» تغییر دهد.
پرداخت باید هم امن باشد و هم سریع.
Fiura بخشهایی از زیرساخت را در اختیار میگیرد تا تیم فنی مجبور نباشد همهچیز را خودش پیادهسازی کند.
در معماری پرداخت، مواردی مانند مدیریت امن API Key، اعتبارسنجی Webhook و کنترل دسترسی به عملیات حساس اهمیت بالایی دارند.
از طرف دیگر، تراکنشها قابل بررسی روی بلاکچین هستند.
اگر تیم مالی یا پشتیبانی بپرسد:
«این پرداخت کجاست؟»
پاسخ فقط یک رکورد داخلی نیست.
txHash یک مرجع قابل بررسی روی شبکه است.
این شفافیت یکی از تفاوتهای اصلی پرداختهای On-chain با بسیاری از سیستمهای پرداخت سنتی است.
Fiura فقط برای فروشگاههای آنلاین طراحی نشده است.
فرض کن یک کسبوکار حضوری میخواهد پرداخت رمزارزی دریافت کند.
میتوان همان شبکهها و موجودی را با یک QR Code در اختیار مشتری قرار داد.
در نتیجه، کسبوکار مجبور نیست برای پرداخت آنلاین و حضوری دو سیستم کاملاً جداگانه داشته باشد.
یک زیرساخت پرداخت؛ چند کانال فروش.
همهٔ مسائل مالی با پرداخت حل نمیشوند.
گاهی یک کسبوکار یا طرف معامله میخواهد بداند آیا یک فرد یا مجموعه توانایی مالی مشخصی دارد یا نه؛ اما نمیخواهد رقم دقیق دارایی خود را افشا کند.
برای این سناریو، Fiura یک لایهٔ جداگانه با نام Fiura Prove دارد.
ایده این است که بتوان حداقل موجودی موردنیاز را اثبات کرد، بدون اینکه مقدار دقیق دارایی آشکار شود.
این قابلیت برای معاملههای سنگینتر میتواند کاربرد داشته باشد؛ برای مثال:
Fiura Prove جای درگاه پرداخت روزمره را نمیگیرد.
درگاه برای انتقال ارزش است؛ Prove برای ایجاد اعتماد قبل از معامله.
برای شروع لازم نیست زیرساخت پیچیدهای داشته باشی.
میتوانی ابتدا در محیط Testnet جریان پرداخت را آزمایش کنی و بعد سراغ Mainnet بروی.
فرآیند کلی برای تیم فنی ساده است:
checkoutUrlمستندات فارسی و انگلیسی، به همراه نمونههای cURL و Node، مسیر Integration را برای توسعهدهنده کوتاهتر میکنند.
هدف این نیست که تیم تو متخصص بلاکچین شود.
هدف این است که پرداخت رمزارزی مثل یک سرویس دیگر در Backend محصولت قابل استفاده باشد.
اگر کسبوکار از اتوماسیون استفاده میکند، Webhook میتواند نقطهٔ اتصال Fiura به سایر سرویسها باشد.
مثلاً:
Payment Confirmed → n8n → CRM
یا:
Payment Confirmed → n8n → Telegram
یا:
Payment Confirmed → n8n → فعالسازی اشتراک SaaS
به این ترتیب، پرداخت فقط یک تراکنش بلاکچینی باقی نمیماند؛ تبدیل میشود به یک Event در سیستم کسبوکار.
برای پذیرش پرداخت رمزارزی، الزاماً به Full Node، Smart Contract یا تیم Blockchain جداگانه نیاز نداری.
اگر یک Backend داری که میتواند API را صدا بزند و یک Endpoint برای دریافت Webhook داشته باشد، بخش اصلی Integration در اختیار توست.
مدل ذهنی ساده است:
محصول تو
↓
Fiura API
↓
Invoice
↓
Checkout
↓
Blockchain Payment
↓
Confirmation
↓
Webhook
↓
Business Logic
↓
Order Completed
این همان چیزی است که یک درگاه پرداخت باید انجام دهد:
نه اینکه تو را مجبور کند زیرساخت بلاکچین بسازی؛ بلکه باید بلاکچین را به یک بخش قابلاستفاده از محصولت تبدیل کند.
شبکههای بلاکچینی دائماً در حال تغییرند و هر شبکه ویژگیها و کاربران خودش را دارد.
به همین دلیل، یک Payment Gateway خوب نباید منطق کسبوکار را به یک شبکهٔ خاص گره بزند.
در Fiura، مدل اصلی بر پایهٔ Invoice، Checkout، Status و Webhook طراحی شده است.
بنابراین با اضافه شدن شبکههای جدید، هدف این است که مدل Integration برای تیم فنی ثابت بماند.
Polkadot نیز در نقشهٔ توسعهٔ Fiura قرار دارد، اما تا زمانی که Checkout آن آمادهٔ استفادهٔ زنده نباشد، شبکههای فعلی مانند BSC، Ethereum و TRON گزینههای اصلی برای ساخت جریان پرداخت هستند.
برای شروع یک پروژهٔ پرداخت رمزارزی لازم نیست ماهها زیرساخت بسازی.
اگر Backend، API و Webhook را در اختیار داری، مسیر میتواند به چند مرحلهٔ مشخص خلاصه شود:
API Key بگیر → Invoice بساز → Checkout را باز کن → پرداخت را دریافت کن → Webhook را پردازش کن.
بقیهٔ کار، منطق محصول توست.
Fiura قرار نیست جای محصولت را بگیرد.
تو محصول را میسازی؛ Fiura کمک میکند ارزش بین مشتری و کسبوکار جابهجا شود و سیستم تو همان لحظه از نتیجه باخبر شود.
اگر محصول، فروشگاه، SaaS، ربات فروش یا سیستم اتوماسیون داری و میخواهی پرداخت رمزارزی را بدون ساخت زیرساخت بلاکچینی از صفر به آن اضافه کنی، Fiura میتواند نقطهٔ شروع Integration تو باشد.