واجهة برمجة تطبيقات إصدار بطاقات العملات الرقمية: دليل عملي لكيفية عملها فعليًا

يتطلب بناء برنامج بطاقات بالطريقة التقليدية وجود بنك راعي، ومعالج بيانات، ومكتب تخصيص، وقسم امتثال، يتم تجميعها عقدًا تلو الآخر. ويُقدّر الناس مدة ذلك بثمانية عشر شهرًا.

تُعدّ واجهة برمجة تطبيقات إصدار البطاقات بمثابة حجّة مفادها أنك لم تعد مضطرًا للقيام بذلك بنفسك. فهي لا تُلغي هذا العمل تمامًا، بل تنقل معظمه إلى جهة أخرى، وما تبقى منه يستحق الفهم قبل التوقيع.

الوجبات السريعة الرئيسية

• تتيح واجهة برمجة تطبيقات إصدار بطاقات العملات المشفرة للشركات إنشاء وإدارة بطاقات الدفع المرتبطة بأرصدة العملات المشفرة، عادةً دون الحاجة إلى امتلاك ترخيص بطاقة خاص بها أو رعاية مصرفية أو مجموعة معالجة.
• تنشر UPay Business إصدار بطاقات Visa المادية والافتراضية من خلال واجهة برمجة تطبيقات واحدة، ورسوم دفع العملات المشفرة أقل من 1 بالمائة مقابل 3 إلى 5 بالمائة التي تفرضها على المدفوعات التقليدية عبر الحدود، وقبول BTC وETH وUSDT وأكثر من 50 أصلًا آخر عبر TRC20 وERC20 وBSC.
• تُعلن UPay Business عن مدة خمس دقائق تقريبًا لتسوية معاملات العملات الرقمية، ومدة T+0 أو T+1 لتسوية معاملات العملات الورقية حسب القناة، مع تسوية المعاملات المصرفية في غضون T+1. هذه مراحل مختلفة، وليست متناقضة، لذا استفسر عن المرحلة التي تنتهي عندها عملية الدفع.
• تنشر وثائق المطورين الخاصة بـ UPay بيئة اختبار، ونافذة صلاحية توقيع مدتها 60 ثانية لكل طلب، وقائمة عناوين IP المسموح بها الإلزامية، وتدرج عنوان URL الأساسي للإنتاج على أنه غير معلن عنه علنًا.
• إن الامتثال الذي ترثه حقيقي: التحقق من الهوية، ومراقبة المعاملات، وفحص العقوبات، وقاعدة السفر عند 3,000 دولار أمريكي في الولايات المتحدة، ومعيار PCI DSS الإصدار 4.0.1، وهو الإصدار النشط الوحيد حاليًا، والذي دخلت متطلباته الـ 51 ذات التاريخ المستقبلي حيز التنفيذ في 31 مارس 2025.
• فيما يتعلق بالتسجيلات، خذ ما تدرجه UPay نفسها: رخصة مشغل خدمات مالية في هونغ كونغ، وموافقة مبدئية من مزود خدمة الأصول الافتراضية الليتواني، وتسجيلات أعمال الخدمات المالية في الولايات المتحدة وكندا.

ما هي واجهة برمجة تطبيقات إصدار بطاقات العملات المشفرة؟

واجهة برمجة تطبيقات إصدار بطاقات العملات المشفرة هي مجموعة من نقاط النهاية القابلة للبرمجة التي تسمح للشركات بإنشاء وتمويل وتجميد وإلغاء بطاقات الدفع المرتبطة برصيد العملات المشفرة للعميل، دون امتلاك الآلات الأساسية.

يمتلك المزوّد العلاقات التي يصعب الحصول عليها: عضوية الشبكة، وترتيبات الإصدار، والمعالجة والتحويل. أما أنت، فتحتفظ بالعميل والعلامة التجارية وقواعد الإنفاق.

تكمن أهمية العملات الرقمية في مرحلة التحويل. البطاقة هي بطاقة عادية على شبكة عادية؛ ما يضيفه مزود الخدمة يحوّل رصيد العملات الرقمية إلى عملة تسوية عند المصادقة، بحيث يرى التاجر معاملة عادية ويرى العميل خصمًا من العملة الرقمية.

كيف يعمل التدفق، خطوة بخطوة

إجراءات التسجيل والتحقق من الهوية. يقوم تطبيقك بجمع بيانات العميل وإرسالها عبر نقاط التحقق الخاصة بمزود الخدمة. تصل النتيجة بشكل غير متزامن، لذا صمم التطبيق بحيث تكون النتيجة معلقة بدلاً من إجابة بنعم أو لا.

تمويل الرصيد. يقوم العميل بتحويل العملات الرقمية إلى الحساب الذي تُسحب منه البطاقة. في UPay، يتم ذلك عن طريق إعادة شحن من محفظة UPay وليس عن طريق الخصم المباشر، لذا فإن الرصيد هو شيء يحرص العميل على تعبئته باستمرار.

إصدار البطاقات وتفعيلها. تُصدر البطاقة الافتراضية بسرعة. أما البطاقة المادية، فيجب إنتاجها وشحنها، ولهذا السبب تتضمن نقاط نهاية بطاقة UPay التفعيل وتتبع الخدمات اللوجستية إلى جانب التسجيل.

التفويض. عند قيام العميل بالدفع، ترسل الشبكة طلب تفويض، ويتحقق المزود من الرصيد وقواعد الإنفاق الخاصة بك، ثم يُجري العملية ويُقرّها أو يرفضها. يجب تحديد أي شيء ترغب في التحكم به مسبقًا.

التسوية والمطابقة. تُسدد المعاملات المُنجزة للتاجر عبر الشبكة، بينما يقوم جانبك بمطابقة البيانات مع إشعارات الويب. يُمثل سجل إشعارات الويب البيانات، بينما تُمثل لوحة التحكم ملخصها.

تغطي ملاحظتنا حول كيفية عمل مدفوعات USDT ما تخبرك به تأكيدات السلسلة فعليًا، وهو المدخل لعملية التسوية هذه.

ما تنشره وثائق واجهة برمجة التطبيقات (API) الخاصة بـ UPay فعلياً

إليكم ما تنص عليه وثائق المطورين وصفحات الأعمال الخاصة بـ UPay.

ما يطلبه المشتري	ما تنشره شركة UPay من مواد خاصة بها	حيثما ورد ذلك
ما هي البطاقات التي يمكنني إصدارها؟	بطاقات فيزا المادية والافتراضية من خلال واجهة برمجة تطبيقات واحدة	موقع UPay للأعمال
هل يوجد صندوق رمل؟	تم نشر بيئة اختبار؛ وتم إدراج بيئة الاختبار على أنها غير متاحة، ولم يتم الكشف عن عنوان URL الأساسي للإنتاج علنًا.	مرجع واجهة برمجة تطبيقات UPay
كيف يتم التحقق من صحة الطلب؟	يتم توقيع كل طلب، ويكون التوقيع صالحاً لمدة 60 ثانية قبل أن يتعين إعادة إنشائه.	مرجع واجهة برمجة تطبيقات UPay
هل توجد قيود على الشبكة؟	يجب أن تكون عناوين IP المستخدمة للاتصال مدرجة في القائمة المسموح بها، ولا تأتي الاستجابات إلا من عناوين محددة.	مرجع واجهة برمجة تطبيقات UPay
ماذا يمكنني أن أفعل بالبطاقة؟	التسجيل، التفعيل، إعادة الشحن، القفل والفتح، الإلغاء، الاستعلام عن الفواتير، تعيين كلمة مرور تجارية، تتبع الشحنات، تأكيد الأمان ثلاثي الأبعاد، الموافقة على مبلغ الإنفاق	مرجع واجهة برمجة تطبيقات UPay
ما الذي تغطيه واجهة برمجة التطبيقات أيضًا؟	التاجر، الحساب، مجموعة العملاء، العميل، العنوان، البطاقة، المحفظة، جهة الاستحواذ، الإنفاق، الإطار المضمن، تحميل الملفات، قائمة المناطق، قائمة الرموز، ومجموعات Webhook	مرجع واجهة برمجة تطبيقات UPay
هل الوثائق باللغة الإنجليزية؟	المرجع الأساسي باللغة الصينية المبسطة؛ ويمكن الاطلاع على نسخة إنجليزية كاملة على الرابط upay-api-en.readme.io (https://upay-api-en.readme.io/)	مرجع واجهة برمجة تطبيقات UPay، الإصداران
كيف أعرف أن شيئاً ما قد حدث؟	إشعارات Webhook لأحداث البطاقات والمحافظ وعمليات الاستحواذ والدفع	مرجع واجهة برمجة تطبيقات UPay
ما هي تكلفة المعالجة؟	أقل من 1% على مدفوعات العملات المشفرة، مقابل 3 إلى 5% المذكورة للمدفوعات التقليدية عبر الحدود	موقع UPay للأعمال
ما مدى سرعة تسوية الأموال؟	حوالي 5 دقائق على سلسلة الكتل (حوالي 5 دقائق)؛ دفع العملات الورقية T+0 أو T+1 حسب القناة؛ تسوية مصرفية T+1	موقع UPay Business وصفحة دفع العملات المشفرة الخاصة به

كلاهما يستحق القراءة قبل تحديد نطاق العمل: قائمة السماح تحدد مكان تشغيل التعليمات البرمجية الخاصة بك، ونافذة التوقيع التي تبلغ مدتها 60 ثانية تحدد كيفية إعادة المحاولة.

تنشر UPay Business حوالي خمس دقائق لتسوية العملات المشفرة، مما يعطي "حوالي 5 دقائق" مقابل 1 إلى 5 أيام عمل للطرق التقليدية، بينما تقول صفحة دفع العملات المشفرة الخاصة بها أن التسوية على السلسلة "يمكن إكمالها في الوقت الفعلي، بينما تكون تسوية العملات الورقية عادةً T+0 أو T+1، اعتمادًا على قناة الدفع"، مع إدراج التسوية المصرفية على أنها T+1.

الرقم السريع هو المرحلة على سلسلة الكتل، بينما يمثل T+0 أو T+1 مرحلة الدفع بالعملة الورقية، لذا اسأل عن المرحلة التي تنتهي عندها رحلتك فعليًا. كما تنشر UPay الرقم الوحيد للعائد على الاستثمار في هذه الفئة: توفير يتراوح بين 20,000 و50,000 دولار أمريكي لكل مليون عملية تتم معالجتها مقارنةً بالأنظمة المصرفية التقليدية.

الامتثال الذي ترثه

تعمل هذه التقنية وفق نظام السرعة. يستغرق إعداد ملف الامتثال ثلاثة أشهر، وهو ما يحدد تاريخ إطلاق المنتج.

التحقق من الهوية. يُعد إصدار البطاقات نشاطًا خاضعًا للتنظيم في جميع الأسواق المهمة لبرامج البطاقات، لذا يتم التحقق من هوية كل حامل بطاقة قبل إصدارها. تنشر UPay نقاط نهاية للإرسال والاستعلام ومتابعة التقدم، لذا يجب أن يُظهر منتجك حالة بين "مُقدّم الطلب" و"مُعتمد".

يوضح دليلنا حول الامتثال لمتطلبات اعرف عميلك في مجال العملات المشفرة ما هي إجراءات التحقق.

مراقبة المعاملات والعقوبات. يتم فحص البيانات بناءً على الأسماء، وبالنسبة للعملات الرقمية، بناءً على عناوين المحافظ. وقد أدرج مكتب مراقبة الأصول الأجنبية التابع لوزارة الخزانة الأمريكية عناوين العملات الرقمية في قائمة العقوبات منذ عام 2018، لذا يُعدّ العنوان مُعرّفًا قابلًا للفحص تمامًا كما هو الحال مع الاسم.

تُعلن UPay عن شركائها في البنية التحتية، وهو ما يتجاوز ما يفعله معظم مزودي الخدمات: التحقق من الهوية مع Sumsub، الذي أعلنت عنه UPay في مايو 2024 ، وتسوية العملات المستقرة مع StraitsX، والبنية التحتية السحابية مع Tencent Cloud. جميع هذه الخدمات الثلاث مُدرجة في UPay Business تحت عنوان "مبنية على شراكات عالمية موثوقة". يمكن التحقق من أسماء الشركاء، بينما لا يمكن التحقق من عبارة "بنية تحتية على مستوى المؤسسات".

قاعدة السفر. في الولايات المتحدة، تنص المادة 31 من قانون اللوائح الفيدرالية 1010.410(و) على ضرورة نقل معلومات المُرسِل والمستفيد مع التحويلات التي تبلغ قيمتها 3,000 دولار أمريكي أو أكثر. وهذه القاعدة أقدم من العملات المشفرة، وهي تنطبق عليها.

معيار أمان بيانات صناعة بطاقات الدفع (PCI DSS). يعتمد أمان بيانات البطاقات على معيار أمان بيانات صناعة بطاقات الدفع. وقد أوقف مجلس معايير أمان صناعة بطاقات الدفع دعم الإصدار 4.0 في 31 ديسمبر 2024، لذا فإن الإصدار 4.0.1 هو الإصدار النشط الوحيد حاليًا.

من بين المتطلبات الـ 64 التي تم تقديمها في الإصدار 4.x، تم تحديد تاريخ 51 منها في المستقبل وأصبحت سارية المفعول في 31 مارس 2025 ، لذا فإن التقييم اليوم يتم مقابل المجموعة الكاملة بدلاً من المجموعة الانتقالية.

إن استخدام حقول البطاقات المستضافة لدى مزود الخدمة يقلل من نطاق صلاحياتك، ولكنه لا يلغيه تمامًا، والسؤال الذي سيطرحه المدقق هو: ما هي الحقول التي يتعامل معها الكود الخاص بك؟

الترخيص. اطلب القائمة وتحقق منها في السجلات الرسمية بدلاً من صفحة التسويق. تُدرج UPay ترخيصًا لمشغل خدمات مالية في هونغ كونغ، وموافقة مبدئية على تقديم خدمات الأصول الافتراضية في ليتوانيا، وتسجيلات أعمال خدمات مالية في الولايات المتحدة وكندا.

نشرت UPay معرّفاتٍ لهذين الكيانين: 31000257909666 للتسجيل الأمريكي وM24993747 للتسجيل الكندي. ابحث عنهما بنفسك في قاعدة بيانات FinCEN لسجلات مؤسسات الخدمات المالية (MSB) وسجل FINTRAC لمؤسسات الخدمات المالية، وإذا لم يُظهر أيٌّ منهما الكيان الذي تتعاقد معه، فاسأل عن السبب قبل المتابعة.

لا تتفق صفحتا UPay على هذا الأمر. فصفحتها الرئيسية تُدرج التراخيص الأربعة على أنها مُحتفظ بها؛ بينما لا تزال صفحة "نبذة عنا" تعرضها ضمن جدول زمني "الأهداف والخطط" كترخيصات للحصول عليها، بتاريخ الربع الثالث من عام 2023 والربع الأول من عام 2024، إلى جانب ترخيص ائتماني لا تُدرجه الصفحة الرئيسية.

هذا هو الوضع الطبيعي لتسويق البائعين، ولهذا السبب فإن السجل وليس الصفحة هو الحل.

التحديات في استخدام واجهات برمجة تطبيقات إصدار بطاقات العملات المشفرة

تختلف القواعد باختلاف السوق والجنسية. ولا يمنحك استخدام واجهة برمجة تطبيقات واحدة منتجًا واحدًا. فقوائم العقوبات وقواعد الشبكة وقائمة الدول الخاصة بالمزود تؤثر جميعها على الجهات التي يمكنك خدمتها.

لا يختفي خطر التحويل، بل ينتقل. يُركّز التحويل عند المصادقة مخاطر العميل في الثواني المحيطة بكل عملية شراء. في حالة الأصول التمويلية المتقلبة، يُعتبر انخفاض الرصيد الذي بدا كافيًا قبل ساعة بمثابة طلب دعم، وليس خللًا برمجيًا.

لا تزال أنت من يتولى بناء الجزء الممل. يشمل ذلك مشاكل واجهة برمجة التطبيقات وبطاقات التحكم، والبيانات، واستقبال النزاعات، وإجراءات التحقق من الأمان ثلاثي الأبعاد، وتذكير إعادة الشحن، وتصدير الضرائب. تقوم الفرق بتحديد نطاق نقاط النهاية وتتجاهل المنتج المحيط بها.

يحتاج عملاؤك إلى التوجيه. تُرفض البطاقة الممولة من محفظة إلكترونية عندما يكون الرصيد غير كافٍ، مع عدم وجود سحب على المكشوف أو إعادة تعبئة تلقائية. وضح ذلك في عملية التسجيل بدلاً من الشروط والأحكام.

أنت تستفيد من استقرار مزود الخدمة. برنامج البطاقات ليس تبعية يمكنك تغييرها في عطلة نهاية الأسبوع. استفسر عما يحدث للبطاقات السارية إذا غيّر مزود الخدمة شريكه المُصدر.

ما يجب التحقق منه قبل التوقيع

أي الأسواق، وبأي معيار؟ تُحدد أهلية البطاقة بناءً على الجنسية وليس الإقامة، وتختلف هذه الأهلية باختلاف البطاقة. ترفض بطاقة UPay Premier الطلبات من قائمة طويلة من الدول والأقاليم، معظمها غير مأهولة أو متنازع عليها.

ترفض بطاقة البلاتينيوم الخاصة بها طلبات حاملي جنسيات من قائمة أقصر بكثير، تشمل الولايات المتحدة والصين والهند وإندونيسيا وباكستان وفيتنام وتركيا والمملكة العربية السعودية وإسرائيل، وغيرها. هذه القائمة المختصرة هي التي تُنهي الصفقات، وتحظر كلتا البطاقتين بشكل كامل حاملي الجنسيات الخاضعة للعقوبات.

تقوم UPay بمراجعة القائمة وتقول إنها تستند إلى Visa وقوائم المخاطر والعقوبات التنظيمية العالمية الرئيسية، لذا احصل على الإصدار الحالي من مركز المساعدة الخاص بها.

من هو المُصدر؟ تُصدر بطاقات UPay من قبل المؤسسات الشريكة وليس من قبل UPay نفسها، وهذه الجهة هي التي تُلزم قواعدها برنامجك.

أعلنت UPay عن جهة واحدة: JC Credit Limited، لإصدار بطاقتها الائتمانية في هونغ كونغ، وذلك بموجب شروط تشير إلى ماستركارد. أما بطاقات Premier وPlatinum الحالية، بالإضافة إلى إصدار واجهة برمجة تطبيقات الأعمال (Business API)، فتعتمد على فيزا. استفسر عن الجهة التي أصدرت بطاقتك.

ما هو السعر المطبق؟ اسأل عن السعر المحدد عند الموافقة، وما هو هامش الربح، ومن يتحمل الفرق بين الموافقة والتسوية.

كيفية الانسحاب. اسأل عما سيحدث لحاملي بطاقاتك في حال مغادرتك، ومن يملك بيانات الاعتماد المشفرة، وما هي الإشعارات المطلوبة. نادرًا ما تجد الإجابة في الوثائق.

هل تفضل التركيز على مقدمي الخدمات بدلاً من الآليات؟ دليلنا لمنصات إصدار بطاقات العملات المشفرة للشركات الناشئة يقارن بينها، كما يغطي قسم البنية التحتية لمدفوعات العملات المشفرة بين الشركات جانب التسوية.

ما الذي يستغرق الوقت فعلاً

يستغرق النشر الأولي الواقعي من ثلاثة إلى أربعة أشهر، وجزء ضئيل منه يتعلق بالهندسة: فالهندسة تستغرق أسابيع، بينما يستغرق ملف الامتثال ربع سنة. كلاهما تقديرات تقريبية وليست أرقاماً منشورة.

تُعدّ عملية التحقق من هوية الشركة ذات الملكية المتعددة المستويات الخطوة التي تستغرق وقتاً طويلاً. لذا، جهّز وثائق التأسيس، ومخطط الملكية، وبيانات تعريف المديرين.

بعد ذلك، يتعلق الأمر بالقرارات بدلاً من التعليمات البرمجية: ما هي ضوابط الإنفاق التي تعرضها، وماذا يفعل الدعم عندما يتم رفض البطاقة في محطة الوقود بسبب حجز مسبق، وكيف يقوم العميل بملء رصيده الذي نفد.

عملية التكامل نفسها هي الجزء القصير، وهي الجزء الذي يشرحه دليل تكامل واجهة برمجة تطبيقات بوابة الدفع الخاصة بنا.

الأسئلة الشائعة

هل يُعدّ دمج واجهة برمجة تطبيقات لإصدار بطاقات العملات المشفرة أمرًا صعبًا؟

عملية التكامل ليست الجزء الصعب. فالتوثيق وبيئة الاختبار وروابط الويب تجعل عملية الهندسة مسألة أسابيع. أما التحقق من شركتك، والحصول على موافقة الامتثال، والشروط التجارية، فتحدد الموعد النهائي.

هل أحتاج إلى ترخيص خاص بي لإصدار البطاقات من خلال واجهة برمجة التطبيقات (API)؟

في الغالب لا: يمتلك المزوّد وشريكه المُصدر التراخيص، وأنت تعمل كمدير برنامج بناءً على هذه التراخيص. هذا موقف تجاري وليس رأيًا قانونيًا، لذا تأكد من ذلك لكل سوق تعمل فيه.

كيف تتعامل بطاقة العملات المشفرة مع تغيرات الأسعار بين عملية الشراء والتسوية؟

يقوم المزوّد بالتحويل عند الموافقة، لذا يُخصم الرصيد من سعر الصرف المُحدد في تلك اللحظة. ويُرحّل الفرق بين الموافقة والتسوية إلى جهة ما، ويحدد العقد مكانها.

ما الفرق بين إصدار البطاقات وبوابة الدفع؟

تتيح لك بوابة الدفع قبول الأموال من العملاء. أما إصدار البطاقات فيمنح العملاء بطاقةً للإنفاق. تشابه في البنية التحتية، لكن المشاكل مختلفة، والعديد من الشركات ترغب في كليهما.

هل يمكنني إصدار بطاقات للعملاء في أي مكان؟

لا. يتضمن برنامج البطاقات قائمة بالدول والجنسيات التي لا يمكنه تقديم خدماته لها، وذلك بسبب العقوبات وقواعد الشبكة. احصل على القائمة الحالية قبل دراسة السوق.