طرق قبول المدفوعات

تستطيع أن تبدأ بلا موقع وبلا مطوّر، وتنتقل إلى الـ API لاحقًا دون تغيير الحساب ولا إعادة التقديم. وكل الطرق التالية تستخدم صفحة الدفع نفسها، ولوحة التحكّم نفسها، وطريقة التحويل نفسها.

روابط الدفع

أنشئ رابطًا من لوحة التحكّم وشاركه بالبريد أو واتساب أو رسالة أو منشور. يدفع العميل على صفحة الدفع الآمنة، وتظهر الدفعة في لوحتك باسمه وبريده الإلكتروني ورقم جوّاله.

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

جلسات الدفع المستضافة

ينشئ سيرفرك جلسة دفع بما يشتريه العميل، ثم يحوّله إلى عنوان الجلسة. يدفع على صفحتنا ويعود إلى العنوان الذي تختاره.

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

الـ REST API

JSON عبر HTTPS على utopia-payments.com/api/v1، بمفتاح سرّي تنشئه من قسم المطوّرين في لوحة التحكّم. والموارد هي المنتجات والعملاء وجلسات الدفع والمدفوعات والاشتراكات وعناوين Webhook والأحداث وحسابك نفسه.

المبالغ أعداد صحيحة بوحدة العملة الصغرى: 34900 تعني 349.00 درهمًا.
القوائم تُقرأ بمؤشّر، فيأتي سجلّ طويل بالترتيب ودون ثغرات.
طلب POST مع مفتاح Idempotency يعيد أوّل إجابة له مدّة 24 ساعة، فإعادة المحاولة بعد انقطاع لا تُحصّل المبلغ مرّتين.
ولكل مفتاح حدّ 240 طلبًا في الدقيقة.

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

مكتبتا Node و PHP

المكتبتان تغطّيان الـ API نفسه، وتحملان أنواعًا معرّفة لكل مورد، وتتحقّقان من توقيع Webhook عنك بنداء واحد.

Node.js

npm install @utopia-payments/node

PHP

composer require utopia-payments/utopia-php

WooCommerce

إضافة ووردبريس تُظهر Utopia وسيلة دفع في صفحة الدفع في WooCommerce: يدفع المشتري على صفحتنا المستضافة، ويُعلَّم الطلب مدفوعًا من إشعار Webhook لا من متصفّح العميل.

نزّل ملف zip من التوثيق وثبّته من Plugins ثم Add New ثم Upload Plugin. والإضافة غير منشورة على WordPress.org بعد، فتحديثها يكون باستبدال الملف.

ولا يوجد تطبيق أصلي لـ Shopify بعد. متاجر Shopify تستخدم رابط دفع من Utopia مع وسيلة دفع يدوية حتى يوجد.

التوثيق

توثيق المطوّرينأدلّة لصفحة الدفع والاشتراكات وإشعارات Webhook والمكتبات.مرجع الـ APIكل نقطة نهاية وكل حقل، مع منشئ طلبات تستدعي به الـ API من الصفحة نفسها.

غير متأكّد أي طريق يناسبك؟ اشرح لنا وضعك على sales@utopia-payments.com.