نقطة نهاية دفع بطلب واحد مع idempotency عبر external_id وcallback_url اختياري لكل دفعة. أدر payroll و affiliate و treasury أو سحوبات العملاء من منطقك الخاص.
تُفعَّل المدفوعات بعد KYB التجاري. Cryptoway تشغّل API بطلب واحد — لا يوجد batch endpoint. الإنتاجية محدودة بـ rate-limit لكل IP (15 req / 15 s).
POST دفعة واحدة لكل طلب — سلوك مُتوقَّع على نطاق واسع، بدون مفاجآت group-dispatch
idempotent عبر external_id
وفِّر معرّفك الخاص لكل دفعة؛ تتم إزالة تكرار retry بنفس القيمة على الخادم
callbacks لكل دفعة
يمكن لكل طلب إعلان callback_url الخاص به — تُسلَّم أحداث الحالة إليك
~60 دفعة/دقيقة
Rate limit: 15 req / 15 s لكل IP. صمِّم schedulers حول هذا السقف
Tier rate + network fee
تسعير tier قياسي (Starter 0.5% / Business 0.3%) + network fee لكل سحب
merchant KYB قياسي
لا توجد خطوة KYC خاصة بالمدفوعات — بمجرد الموافقة على merchant KYB، تعمل المدفوعات
تكامل المطور
API بطلب واحد — idempotent، callback-driven
POST سحبًا واحدًا في كل مرة — جدول، عتبة، لكل حدث، ما يحتاجه منطق عملك. وفِّر external_id لـ retry آمن و callback_url لأحداث الحالة. المشغل يمتلك الحجم؛ الـ API يمتلك التسليم.
كل طلب يعالج مستلمًا واحدًا بالضبط. لإرسال N دفعات، تقوم بعمل N استدعاءات. هذا متعمد — لكل دفعة حالتها الخاصة، callback الخاص بها، audit-trail الخاص بها. خطِّط لـ scheduler الخاص بك وفقًا لذلك.
02
external_id هو مفتاح التاجر
وفِّر معرّفًا فريدًا خاصًا بك لكل دفعة (UUID، order ID، دورة payroll — ما يناسب). يستخدمه Cryptoway لـ idempotency وتستخدمه أنت للتسوية مع ledger الخاص بك. تتم إزالة تكرار retry مع نفس external_id.
03
الإنتاجية محدودة بـ rate-limit
15 طلبًا لكل 15 ثانية لكل IP — حوالي 60 دفعة في الدقيقة على worker واحد. تحتاج إلى المزيد؟ وزِّع عبر عدة IPs أو تواصل مع sales لشروط حجم عالي.
من يستخدمها
أين تؤتي المدفوعات الآلية ثمارها
Payroll للمتعاقدين
ادفع للمتعاقدين عن بعد بـ USDT وفق جدول. external_id = متعاقد + فترة، callback_url يُحدِّث نظام HR عند التسليم.
مكافآت برنامج الـ affiliate
مدفوعات tier-based آلية على أحداث attribution. أدر من محرك attribution الخاص بك؛ Cryptoway تسلِّم.
سحوبات العملاء / اللاعبين
وجِّه طلبات السحب من واجهة مستخدم منتجك مباشرة إلى الـ API. تحافظ idempotency على retry آمن تحت الحمل.
الـ treasury والعمليات
تحويلات دورية بين المحافظ، مكتوبة بـ script من ops scheduler الخاص بك — كرِّر الـ API بطلب واحد على سقف rate-limit.
المقارنة
مدفوعات Cryptoway مقابل السكك المصرفية التقليدية
المدفوعات المصرفية التقليديةCryptoway payouts API
وقت الإعدادأيام — اتفاقيات wire، التحقق من المستفيدين لكل مستلمدقائق — merchant KYB مرة واحدة، ثم وصول API
تسوية لكل دفعةT+1 إلى T+3 أيام مصرفيةدقائق على معظم الشبكات، يعتمد على chain confirmation
Idempotencyيعتمد على البنك — غير موجود عادةً، تسوية يدويةexternal_id يُزيل تكرار retry على الخادم
تحديثات الحالةسحب البيانات في نهاية اليومpush callbacks لكل دفعة (callback_url)
العمولةwire fee + FX spread لكل مستلمtier rate + network fee لكل دفعة
FAQ
مدفوعات العملات المشفرة الآلية عبر API
لا. الـ API بطلب واحد — POST /api/user/balance/withdrawal/ يعالج مستلمًا واحدًا لكل طلب. لإرسال N دفعات، قم بـ N استدعاءات. هذا حسب التصميم: لكل دفعة حالتها الخاصة، callback، و audit-trail.
15 طلبًا لكل 15 ثانية لكل IP — حوالي 60 دفعة في الدقيقة على worker واحد. تحتاج إلى المزيد؟ وزِّع عبر عدة IPs أو تواصل مع sales لشروط حجم عالي.
وفِّر external_id في كل دفعة — معرّف فريد تتحكم به. تتم إزالة تكرار retry مع نفس external_id على الخادم. اختر قيمة مرتبطة بـ ledger الخاص بك (UUID، order ID، دورة payroll) لتسوية نظيفة.
دقائق على معظم الشبكات. الوقت الدقيق يعتمد على chain confirmation — تصفى TRC20 و Polygon عادةً في 1-3 دقائق، بينما يستغرق BTC و ETH وقتًا أطول عند ارتفاع gas. Cryptoway لا تعد بالتسوية الفورية.
إذا فشلت الدفعة (عنوان غير صالح، gas غير كافٍ، شبكة معطلة)، تعود الأموال إلى رصيد merchant الخاص بك ويتلقى callback_url حدث فشل. أعد الإرسال بـ external_id جديد بمجرد حل المشكلة الأساسية.
يُطبَّق التسعير القياسي لـ tier (Starter 0.5%، Business 0.3% — انظر /pricing) بالإضافة إلى network fee لكل سحب. لا يوجد SKU منفصل لـ "payouts pricing".
