API البداية السريعة

اختر فريقًا ومفتاح API

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

قاعدة URL

يتم إصدار جميع مسارات MakeCrypto الشريكة API ضمن أصل الإنتاج.

https://www.makecrypto.io/api/partner/v1

للتطوير المحلي، استخدم أصل MakeCrypto المحلي الخاص بك بنفس بنية المسار.

المصادقة

يجب أن ترسل عمليات تكامل الخادم معرف مفتاح MakePay API وسر API عند كل طلب. يتم إرجاع السر فقط عند إنشاء مفتاح API، لذا احتفظ به في مدير الأسرار من جانب الخادم ولا تشحنه أبدًا إلى متصفحات العملاء.

أولا قراءة الطلب

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

curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

قم أولاً بإنشاء الطلب

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

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}'

قائمة المراجعة التشغيلية

• قم بإنشاء مفتاح API باستخدام المنتج makepay.
• قم بتكوين أصل الوجهة الافتراضية للشركة قبل إنشاء الروابط.
• قم بتخزين سر API خارج التحكم بالمصدر وحزم الواجهة الأمامية.
• تعامل مع رابط الدفع UIDs كمعرفات عامة، ولكن احتفظ بمعرفات الطلب الداخلية في payload.orderId أو payload.metadata.
• استمع إلى webhooks أو قم باستقصاء حالة رابط الدفع/الجلسة من البوابة حتى يصبح تدفق webhook للواجهة الخلفية مباشرًا.