پرش به مطلب اصلی

نمای کلی Payment Intentها

Payment Intentها روش اصلی پذیرش پرداخت کریپتو با OrcaRail هستند. راهی امن و انعطاف‌پذیر برای دریافت وجه از مشتریان فراهم می‌کنند.

Payment Intent چیست؟​

Payment Intent نشان‌دهنده قصد شما برای دریافت وجه از یک مشتری است. چرخه عمر پرداخت را از ساخت تا تکمیل پیگیری می‌کند.

جریان Payment Intent برای پرداخت با استیبل‌کوین از الگوی آشنای ساخت–تأیید–انتقال استفاده می‌کند:

  1. یک PaymentIntent بسازید تا client_secret دریافت کنید
  2. intent را تأیید کنید تا next_action.redirect_to_url.url دریافت کنید
  3. کاربر را به اپ پرداخت میزبانی‌شده منتقل کنید
  4. پس از تأیید پرداخت، کاربر با پارامترهای کوئری به return_url شما برمی‌گردد

وضعیت‌های Payment Intent​

Payment Intentها در طول چرخه عمرشان چند وضعیت را طی می‌کنند:

  • requires_payment_method — PaymentIntent ساخته شده اما هنوز روش پرداختی به آن متصل نشده است
  • requires_confirmation — PaymentIntent روش پرداخت دارد اما باید تأیید شود
  • processing — PaymentIntent در حال پردازش است
  • succeeded — PaymentIntent موفق شده و پرداخت پردازش شده است
  • canceled — PaymentIntent لغو شده است

روش‌های پرداخت پشتیبانی‌شده​

در حال حاضر OrcaRail از این‌ها پشتیبانی می‌کند:

  • کریپتو — پرداخت با استیبل‌کوین (USDC، USDT و غیره)

شبکه‌های پشتیبانی‌شده​

OrcaRail از پرداخت روی چندین شبکه بلاکچین پشتیبانی می‌کند. هنگام ساخت Payment Intent باید هم tokenId و هم networkId را مشخص کنید.

شبکه‌های رایج شامل این‌ها هستند:

  • Ethereum
  • Polygon
  • Base
  • Arbitrum

برای تصویر کامل شبکه‌ها و ارزهای پشتیبانی‌شده (با قدرت Relay و به‌روزرسانی خودکار)، مطلب وبلاگ ما را ببینید: شبکه‌ها و ارزهای پشتیبانی‌شده.

جریان پرداخت​

مفاهیم کلیدی​

Client Secret​

client_secret شناسه یکتای Payment Intent است. برای تأیید Payment Intent استفاده می‌شود و باید امن نگه داشته شود. فقط یک بار، هنگام ساخت Payment Intent، نمایش داده می‌شود.

آدرس بازگشت​

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

فراداده​

می‌توانید metadata سفارشی به Payment Intentها پیوست کنید. این برای ذخیره اطلاعات بیشتر درباره پرداخت، مثل شناسه سفارش یا اطلاعات مشتری، مفید است.

آدرس برداشت​

هنگام ساخت یا ویرایش Payment Intent می‌توانید به‌طور اختیاری withdrawal_addresses را تعیین کنید (شیء کلید-مقدار: نوع زنجیره به آدرس، مثلاً { "evm": "0x...", "solana": "..." }). اگر برای یک نوع زنجیره تعیین شود، هنگام اجرای برداشت خودکار وجوه به همان آدرس برداشت می‌شود. اگر برای یک زنجیره حذف یا خالی باشد، مقدار پیش‌فرض حساب شما در تنظیمات برداشت برای آن نوع زنجیره استفاده می‌شود.

کارمزدها و حداقل‌ها​

استفاده میزبانی‌شده: برای قیمت هر تراکنش و سطح رایگان OrcaRail ابری، تعرفه پلتفرم میزبانی‌شده را ببینید.

برای هر پرداخت (پیش‌فاکتور): پرداخت‌ها می‌توانند شامل کارمزد پشتیبانی، کمیسیون (از کلید API شما) و کارمزد پل (وقتی پرداخت‌کننده از توکن یا شبکه دیگری استفاده می‌کند) باشند. مبالغ همچنین تابع حداقل پرداخت و حداقل برداشت اختیاری هستند. برای جزئیات کامل، کارمزدها و محدودیت‌ها را ببینید.

قدم‌های بعدی​