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

دریافت پرداخت USDC روی Base، سولانا و اتریوم

· خواندن 8 دقیقه
OrcaRail
Crypto payment rails for web2 apps

برای دریافت پرداخت USDC فقط یک آدرس کیف پول کافی نیست. به شبکه درست، راهی برای تطبیق هر پرداخت با سفارش آن و خبری قابل‌اعتماد برای بک‌اند خود نیاز دارید. USDC (یو اس دی سی) یک استیبل‌کوین دلاری است که Circle منتشر می‌کند؛ پس مشتریان تقریباً از هر جای دنیا می‌توانند پرداخت کنند و لازم نیست قیمت محصولاتتان را با یک رمز ارز پرنوسان تعیین کنید.

بخش سخت کار، شبکه است. USDC روی ده‌ها بلاکچین وجود دارد و اگر روی یک شبکه فرستاده شود، روی شبکه دیگر دریافت نمی‌شود. این راهنما Base، سولانا و اتریوم را مقایسه می‌کند، آدرس رسمی قراردادهای USDC را فهرست می‌کند، هزینه پرداخت با USDC را توضیح می‌دهد و نشان می‌دهد چطور با OrcaRail روی هر کدام از این شبکه‌ها USDC دریافت کنید.

دو راه برای دریافت USDC​

اشتراک‌گذاری آدرس کیف پولاستفاده از درگاه پرداخت USDC
راه‌اندازیآدرستان را کپی می‌کنیدحساب و کلید API می‌سازید یا یک افزونه نصب می‌کنید
تطبیق پرداخت با سفارشدستی، با مبلغ و زمانخودکار: یک پرداخت برای هر سفارش
شبکه اشتباه یا پرداخت ناقصدیر متوجه می‌شویدصفحه پرداخت، شبکه و مبلغ دقیق را نشان می‌دهد
وضعیت سفارش در اپلیکیشن شمانداردوب‌هوک، وقتی پرداخت تأیید شد
هزینهفقط کارمزد شبکهکارمزد شبکه به‌علاوه کارمزد درگاه

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

USDC را روی کدام شبکه بپذیریم: Base، سولانا یا اتریوم​

Baseسولانا (Solana)اتریوم (Ethereum)
چیستلایه ۲ اتریوم (EVM)یک بلاکچین مستقلشبکه اصلی و اولیه EVM
کارمزد شبکه برای پرداخت‌کنندهکمکمبیشترین بین این سه
کیف پول پرداخت‌کنندههر کیف پول EVMکیف پول سولاناهر کیف پول EVM
آدرس دریافت شماآدرس EVM شما (0x…)یک آدرس سولاناهمان آدرس EVM که روی Base دارید
اشتراک با پرداخت خودکار (auto-charge) در OrcaRailبلهبلهبله

چند قاعده عملی:

  • با Base یا سولانا شروع کنید اگر می‌خواهید کارمزد مشتریانتان کم باشد.
  • اتریوم را نگه دارید برای مشتریانی که USDC خود را آنجا نگه می‌دارند و برای پرداخت‌های بزرگ‌تر که کارمزد شبکه در آن‌ها اهمیت کمتری دارد.
  • نوع کیف پولتان را بررسی کنید. یک کیف پول معمولی EVM (با یک کلید خصوصی) روی همه شبکه‌های EVM همان آدرس 0x را دارد. کیف پول قرارداد هوشمند، مثل کیف پول چندامضایی، باید روی هر شبکه‌ای که در آن پرداخت می‌گیرید ساخته شده باشد.
  • بگذارید مشتری انتخاب کند. با OrcaRail یک شبکه را برای دریافت انتخاب می‌کنید و مشتریان باز هم می‌توانند از شبکه دیگری پرداخت کنند (پایین‌تر را ببینید).

وقتی API زنده OrcaRail را در ۱۲ نوامبر ۲۰۲۶ بررسی کردیم، USDC روی ۴۳ شبکه از ۷۰ شبکه اصلی (mainnet) فعال فهرست شده بود و نسخه پل‌شده USDC.e روی ۷ شبکه دیگر. فهرست کامل و به‌روز در شبکه‌ها و توکن‌ها است.

آدرس قرارداد USDC روی Base، سولانا، اتریوم و شبکه‌های دیگر​

یک نماد روی هر شبکه یک توکن جداست، پس همیشه آدرس قرارداد را بررسی کنید. این‌ها آدرس‌های USDC بومی (native) هستند که Circle منتشر می‌کند (فهرست Circle، بررسی‌شده در ۱۲ نوامبر ۲۰۲۶). API ‏OrcaRail هم همین آدرس‌ها را فهرست می‌کند:

شبکهآدرس قرارداد USDC
Ethereum0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
Base0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
SolanaEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Arbitrum0xaf88d065e77c8cC2239327C5EDb3A432268e5831
Optimism (OP Mainnet)0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85
Polygon PoS0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
Avalanche C-Chain0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E

مراقب توکن‌های مشابه باشید. روی بعضی شبکه‌ها USDC.e یا «Bridged USDC» هم می‌بینید: نسخه‌ای از USDC که با یک پل (bridge) از شبکه دیگری آورده شده است. آدرس قرارداد خودش را دارد و توکنی متفاوت از USDC بومی است. فهرست Circle برای BNB Chain هم ردیفی ندارد، پس USDC روی BNB Chain، USDC بومی Circle نیست. API ‏OrcaRail فیلد contractAddress هر توکن را برمی‌گرداند؛ پیش از ذخیره کردن tokenId آن را بررسی کنید.

OrcaRail پرداخت‌های USDC را چطور مدیریت می‌کند​

شما انتخاب می‌کنید کجا دریافت کنید، مثلاً USDC روی Base. مشتری در صفحه پرداخت میزبانی‌شده انتخاب می‌کند چطور بپردازد:

  • USDC روی همان شبکه (USDC روی Base): یک انتقال مستقیم، بدون تبدیل.
  • USDC روی شبکه دیگر (مثلاً سولانا یا اتریوم) یا توکن دیگر (تتر، ETH، SOL و غیره): Relay آن را از طریق پل منتقل یا تبدیل می‌کند. پیش‌فاکتور یک کارمزد bridge اضافه می‌کند که مشتری می‌پردازد، پس شما همچنان کل مبلغ را دریافت می‌کنید.

مشتری پیش از پرداخت، مبلغ، شبکه و هر کارمزدی را می‌بیند. وقتی پرداخت تأیید شد، بک‌اند شما وب‌هوک دریافت می‌کند و پرداخت به آدرس برداشت شما منتقل می‌شود.

چطور با OrcaRail پرداخت USDC دریافت کنیم​

  1. یک سندباکس بسازید. در app.orcarail.com ثبت‌نام کنید و یک سازمان سندباکس رایگان با کلید API از نوع ak_test_ بسازید. سندباکس فقط روی تست‌نت کار می‌کند و پول واقعی جابه‌جا نمی‌شود.

  2. شناسه توکن USDC و شبکه را پیدا کنید. شبکه‌ها و بعد توکن‌های شبکه‌ای را که می‌خواهید روی آن دریافت کنید فهرست کنید:

    curl -s "https://api.orcarail.com/api/v1/payments/networks?testnet=true" \
    | jq -r '.[] | select(.isActive) | "\(.id) \(.name)"'
    curl -s "https://api.orcarail.com/api/v1/payments/networks/<networkId>/tokens" \
    | jq '.[] | select(.symbol == "USDC") | {id, contractAddress}'

    در سندباکس از testnet=true استفاده کنید (مثلاً Base Sepolia) و برای mainnetها از testnet=false. مقدار contractAddress را با جدول بالا مقایسه کنید.

  3. آدرس‌های برداشت را تنظیم کنید. یک آدرس EVM برای Base، اتریوم و بقیه شبکه‌های EVM کافی است. اگر روی سولانا دریافت می‌کنید، یک آدرس سولانا هم اضافه کنید. آن‌ها را در Withdrawal Settings یا برای هر پرداخت با withdrawal_addresses تنظیم کنید. استراتژی برداشت را ببینید.

  4. یک payment intent بسازید و تأیید کنید، با مبلغ به ارز خودتان (مثلاً "25.00" و "usd")، tokenId و networkId مربوط به USDC و یک return_url. بعد مشتری را به آدرس صفحه پرداخت میزبانی‌شده بفرستید. کد Node.js و PHP در راهنمای API پرداخت با استیبل‌کوین آمده است.

  5. با USDC آزمایشی پرداخت کنید. USDC آزمایشی رایگان را روی Base Sepolia، Ethereum Sepolia یا Arbitrum Sepolia از فاست Circle بگیرید، یا در سندباکس روی Simulate payment کلیک کنید.

  6. وب‌هوک را مدیریت کنید. با رویداد payment_intent.completed سفارش را پرداخت‌شده علامت بزنید.

  7. به حالت live بروید، با یک سازمان live و کلید ak_live_.

کدنویسی بلد نیستید؟ افزونه ووکامرس دریافت USDC را به فروشگاه وردپرسی اضافه می‌کند و یک فاکتور ارز دیجیتال با لینک پرداخت برای صورت‌حساب‌های یک‌باره مناسب است.

دریافت اشتراک با USDC​

USDC برای پرداخت دوره‌ای هم کار می‌کند. با پرداخت خودکار (auto-charge) روی شبکه‌های EVM و سولانا، مشتری یک بار تأیید می‌کند (یک allowance از نوع ERC-20 یا یک delegation از نوع SPL) و OrcaRail در هر دوره صورت‌حساب مبلغ را برداشت می‌کند. اشتراک‌های OrcaRail و پرداخت دوره‌ای با ارز دیجیتال را ببینید.

هزینه پرداخت با USDC​

  • کارمزد شبکه. فرستنده آن را به بلاکچین می‌پردازد و به شبکه و میزان شلوغی آن بستگی دارد. Base و سولانا معمولاً ارزان‌اند؛ اتریوم معمولاً گران‌ترین است.
  • کارمزد bridge. فقط وقتی مشتری روی شبکه دیگر یا با توکن دیگری پرداخت کند. Relay آن را محاسبه می‌کند، در پیش‌فاکتور نمایش داده می‌شود و مشتری آن را می‌پردازد. کارمزدها را ببینید.
  • کارمزد درگاه. کارمزد OrcaRail برای هر تراکنش تکمیل‌شده ۰٫۵٪ است، پس از ۱۰۰ تراکنش رایگان اول (قیمت‌گذاری).

برای مقایسه ارائه‌دهندگان، فهرست درگاه‌های پرداخت ارز دیجیتال را ببینید.

پرسش‌های متداول​

بهترین شبکه برای دریافت USDC کدام است؟​

برای کارمزد کم، Base یا سولانا. اتریوم بیشترین پشتیبانی کیف پول را دارد، اما کارمزد شبکه‌اش از همه بیشتر است. با OrcaRail لازم نیست به‌جای مشتریانتان انتخاب کنید: شما محل دریافت را انتخاب می‌کنید و آن‌ها می‌توانند با USDC از شبکه پشتیبانی‌شده دیگری پرداخت کنند.

اگر USDC را روی Base دریافت کنم، مشتری می‌تواند با USDC روی سولانا پرداخت کند؟​

بله. Relay پرداخت را از طریق پل منتقل می‌کند و پیش‌فاکتور یک کارمزد bridge اضافه می‌کند که مشتری می‌پردازد. شما کل مبلغ را به‌صورت USDC روی Base دریافت می‌کنید.

فرق USDC و USDC.e چیست؟​

Circle روی شبکه‌های فهرست خودش USDC را به‌صورت بومی منتشر می‌کند. USDC.e همان USDC پل‌شده است: نسخه‌ای از USDC شبکه‌ای دیگر که یک پل (bridge) ساخته است. این دو آدرس قرارداد متفاوتی دارند و دو توکن جدا هستند، پس پیش از پذیرفتن هر کدام آدرس را بررسی کنید.

USDC با تتر (USDT) فرق دارد؟​

هر دو استیبل‌کوین دلاری‌اند، اما از دو ناشر متفاوت: USDC را Circle و تتر (USDT) را Tether منتشر می‌کند. OrcaRail هر دو را می‌پذیرد و وقتی مشتری با یکی پرداخت می‌کند، می‌توانید دیگری را دریافت کنید. راهنمای درگاه پرداخت تتر را ببینید.

چطور پرداخت USDC را رایگان آزمایش کنم؟​

از یک سازمان سندباکس استفاده کنید. USDC آزمایشی را از فاست Circle بگیرید (راهنمای فاست‌های تست‌نت را ببینید) یا روی Simulate payment کلیک کنید. پرداخت شبیه‌سازی‌شده هرگز قابل برداشت نیست.


شروع در سندباکس · شبکه‌ها و توکن‌ها · قیمت‌گذاری