نهان سپهراز زیرساخت تا تجربه
محصول پرداخت رمزارزی نهان سپهر

پرداخت رمزارزی، از تراکنش شبکه تا نتیجه‌ای روشن و قابل پیگیری

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

USDT · BEP20 Hosted checkout Signed webhook
اجزای محصول

یک تجربه واحد برای مشتری، توسعه‌دهنده و عملیات مالی

هر لایه با قرارداد وضعیت مشترک به لایه بعدی متصل است؛ بنابراین آنچه مشتری در checkout می‌بیند با نتیجه API، پنل و webhook سازگار باقی می‌ماند.

Checkout اختصاصی

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

API پذیرنده

ساخت payment session از backend با API Key و قواعد idempotency برای جلوگیری از فاکتور تکراری.

Webhook امضاشده

اعلام تغییر وضعیت با HMAC SHA-256، شناسه یکتای delivery و امکان retry در صورت خطا.

آدرس مستقل فاکتور

تفکیک دریافت هر invoice برای ردیابی دقیق‌تر تراکنش و اتصال آن به سفارش پذیرنده.

PAYMENT FLOW

از سفارش فروشگاه تا نتیجه نهایی

مراحل پرداخت به وضعیت‌های قابل مشاهده تقسیم شده‌اند تا تیم پذیرنده بداند هر سفارش دقیقاً در چه نقطه‌ای قرار دارد.

۰۱CREATING

ساخت درخواست

پذیرنده مبلغ و شناسه سفارش را از پنل یا API ثبت می‌کند.

۰۲WAITING_PAYMENT

آماده‌شدن checkout

آدرس دریافت، مبلغ USDT و مهلت پرداخت در اختیار مشتری قرار می‌گیرد.

۰۳WATCHING

پایش انتقال

دریافت روی شبکه بررسی می‌شود و وضعیت invoice به‌روزرسانی می‌گردد.

۰۴CONFIRMED

ثبت و اعلام نتیجه

نتیجه نهایی ثبت و با webhook امضاشده به پذیرنده اعلام می‌شود.

کنترل وضعیت و ریسک

حالت غیرعادی نباید شبیه پرداخت موفق دیده شود.

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

REVIEW_REQUIREDتفکیک پرداختی که به بررسی عملیاتی نیاز دارد
Idempotent creationجلوگیری از invoice تکراری برای یک سفارش
Final means finalوضعیت CONFIRMED downgrade نمی‌شود
مسیر اتصال

از اولین API Key تا دریافت webhook

اتصال استاندارد نهان رمز server-side است؛ کلید محرمانه در backend می‌ماند و تایید سفارش بر اساس webhook امضاشده انجام می‌شود.

STEP 01

دریافت API Key

کلید فعال را از پنل بگیرید و فقط در محیط امن backend نگه دارید.

STEP 02

ساخت payment session

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

STEP 03

اعتبارسنجی نتیجه

امضای HMAC را روی raw body بررسی و deliveryها را idempotent پردازش کنید.

POSThttps://checkout.nahansepehr.ir/api/v1/payment-sessionsمشاهده نمونه درخواست
تجربه مشتری

اطلاعات لازم، بدون ابهام و شلوغی

مشتری مبلغ دقیق، شبکه صحیح، آدرس اختصاصی و مهلت پرداخت را می‌بیند و برای تایید نیازی به ثبت دستی tx hash ندارد.

مبلغ و آدرس قابل کپی QR متناسب با invoice هشدار روشن شبکه BEP20 نمایش زنده وضعیت و انقضا
تجربه پذیرنده

از لینک پرداخت تا سابقه عملیاتی

پنل، API Key، payment session، webhook و گزارش تحویل‌ها یک مسیر فنی و عملیاتی مشترک دارند.

ساخت لینک از پنل یا API وضعیت‌های پایدار و مستند webhook با امضای HMAC retry و سابقه delivery
قاعده تایید سفارش

بازگشت کاربر از checkout، جایگزین webhook نیست.

تصمیم مالی باید بر اساس وضعیت ثبت‌شده و پیام امضاشده انجام شود؛ نه صرفاً مشاهده صفحه موفق یا بازگشت مرورگر مشتری.

امنیت webhook

اتصال نهان رمز را شروع کنید.

حساب پذیرنده را بسازید یا قرارداد API و webhook را در مستندات بررسی کنید.