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

API پرداخت با استیبل‌کوین: اتصال USDC و تتر در یک بعدازظهر

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

یک API پرداخت با استیبل‌کوین به بک‌اند شما اجازه می‌دهد از مشتری با USDC یا USDT (تتر) پول بگیرد، بدون اینکه نود بلاک‌چین اجرا کنید یا واریزها را دستی با سفارش‌ها تطبیق دهید. یک پرداخت می‌سازید، مشتری را به صفحه پرداخت می‌فرستید و وقتی پول رسید وب‌هوک می‌گیرید.

این راهنما توضیح می‌دهد چنین APIای چه می‌کند، پیش از انتخاب چه چیزهایی را بررسی کنید و چطور API در OrcaRail را از ابتدا تا انتها وصل کنید. اگر بک‌اندی با جدول سفارش دارید، کل این مسیر در یک بعدازظهر جا می‌شود.

API استیبل‌کوین چیست​

«API استیبل‌کوین» سه نوع محصول متفاوت را در بر می‌گیرد:

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

اگر چیزی می‌فروشید و می‌خواهید با USDC یا USDT پول بگیرید، نوع سوم را لازم دارید: API پرداخت با استیبل‌کوین که به آن API پرداخت ارز دیجیتال هم می‌گویند. ادامه این مطلب درباره همین است.

یک API پرداخت با استیبل‌کوین باید چه کارهایی انجام دهد​

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

نگاهی کوتاه به API در OrcaRail​

آدرس پایهhttps://api.orcarail.com/api/v1
احراز هویتBasic Auth با کلید و رمز API (ak_live_ / ak_test_)
شیء اصلیPayment intent
وب‌هوکHMAC SHA-256، با امضای زمان‌دار در برابر ارسال تکراری
SDKNode.js، PHP، Laravel Cashier
شبکه‌هابیش از ۷۰ شبکه اصلی (EVM، Solana، Bitcoin)؛ Tron هنوز پشتیبانی نمی‌شود
کارمزد۰٫۵٪ برای هر تراکنش تکمیل‌شده، ۱٬۰۰۰ تراکنش اول رایگان (قیمت‌ها)

وقتی API زنده را در ۲۹ اکتبر ۲۰۲۶ بررسی کردیم، USDC روی ۴۳ شبکه و USDT روی ۳۰ شبکه فهرست شده بود. فهرست فعلی در شبکه‌ها و توکن‌ها است.

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

۱. کلید سندباکس بگیرید​

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

۲. توکن و شبکه دریافتی را انتخاب کنید​

curl -s "https://api.orcarail.com/api/v1/payments/networks?testnet=true"
curl -s "https://api.orcarail.com/api/v1/payments/networks/<networkId>/tokens"

مقدار networkId و tokenId را ذخیره کنید، مثلاً USDC روی Base Sepolia در زمان تست. مشتری همچنان می‌تواند در صفحه پرداخت با توکن یا شبکه دیگری بپردازد؛ پیش‌فاکتور کارمزد پل را اضافه می‌کند که مشتری می‌پردازد و شما مبلغ کامل را دریافت می‌کنید.

۳. یک payment intent بسازید و تأیید کنید​

با SDK در Node:

import OrcaRail from '@orcarail/node'

const orcarail = new OrcaRail(process.env.ORCARAIL_API_KEY!, process.env.ORCARAIL_API_SECRET!)

const intent = await orcarail.paymentIntents.create({
  amount: '49.00',
  currency: 'usd',
  payment_method_types: ['crypto'],
  tokenId: process.env.RECEIVE_TOKEN_ID!,
  networkId: process.env.RECEIVE_NETWORK_ID!,
  return_url: 'https://yourapp.com/success',
  cancel_url: 'https://yourapp.com/cancel',
  metadata: { order_id: '12345' },
})

const confirmed = await orcarail.paymentIntents.confirm(intent.id, {
  client_secret: intent.client_secret!,
})
// Redirect the customer to the hosted pay URL from `confirmed`.

SDK در PHP (composer require orcarail/orcarail-php) همین فراخوانی‌ها را دارد: $orcarail->paymentIntents->create([...]). هر دو روی endpointهای REST ساخته شده‌اند.

۴. وب‌هوک را بررسی و سفارش را تحویل دهید​

app.post('/webhooks/orcarail', express.raw({ type: 'application/json' }), (req, res) => {
  const event = orcarail.webhooks.constructEventFromHeaders(req.body, req.headers, process.env.ORCARAIL_API_SECRET!)
  if (event.type === 'payment_intent.completed') {
    // In production, also require event.livemode === true.
    // Mark order event.data.object.metadata.order_id as paid (idempotently).
  }
  res.sendStatus(200)
})

constructEventFromHeaders امضای HMAC را بررسی می‌کند و ارسال‌های قدیمی‌تر از ۵ دقیقه را رد می‌کند. رویدادهای سندباکس livemode: false دارند؛ هرگز برای آن‌ها کالای واقعی نفرستید. امضای وب‌هوک و رویدادها را ببینید.

۵. تست کنید، سپس زنده شوید​

در سندباکس روی Simulate payment بزنید یا orcarail.paymentIntents.simulate(id) را صدا بزنید تا پرداخت بدون کیف پول تکمیل شود (شبیه‌سازی پرداخت). می‌توانید با توکن‌های تستی از فاست‌های تست‌نت هم پرداخت کنید. وقتی مسیر کار کرد، به سازمان live و کلید ak_live_ بروید.

فراتر از پرداخت یک‌باره​

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

آیا API پرداخت با استیبل‌کوین رایگان وجود دارد؟​

API میزبانی‌شده OrcaRail پس از ۱٬۰۰۰ تراکنش رایگان اول، ۰٫۵٪ برای هر تراکنش تکمیل‌شده می‌گیرد. نسخه خودمیزبان کارمزد OrcaRail ندارد. کارمزد شبکه همچنان اعمال می‌شود.

آیا می‌توانم USDC و USDT را با یک اتصال بپذیرم؟​

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

API از کدام شبکه‌ها پشتیبانی می‌کند؟​

بیش از ۷۰ شبکه اصلی، از جمله Ethereum، Base، Polygon، Arbitrum، Optimism، Solana و Bitcoin. Tron هنوز پشتیبانی نمی‌شود. شبکه‌ها و توکن‌ها را ببینید.

چطور بدون پول واقعی تست کنم؟​

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

این با APIهای استیبل‌کوین Stripe یا Coinbase چه فرقی دارد؟​

Stripe پرداخت‌های استیبل‌کوین را به فیات در حساب Stripe شما تسویه می‌کند. Coinbase Business وجوه را در حساب کوین‌بیس نگه می‌دارد. OrcaRail وجوه را به کیف پول‌هایی می‌فرستد که در اختیار شماست. جایگزین‌های Coinbase Commerce و فهرست درگاه‌های پرداخت ارز دیجیتال را ببینید.

دریافت کلید سندباکس · مرجع API · قیمت‌ها