البدء

خريطة سريعة لما تفعله مع واجهة برمجة تطبيقات p3p، بالترتيب.

1. احصل على مفتاح API الخاص بك

تواصل معنا على تيليجرام لطلب مفتاح. ستتلقى سلسلة نصية مثل:

YOUR_P3P_API_KEY

2. أرفقه بالطلبات

أرسل مفتاحك كرأس api-key في كل استدعاء لنقاط النهاية:

api-key: YOUR_P3P_API_KEY

3. التنفيذات

اختر الواجهة التي تحتاجها.

3.1. التبادل

عملة رقمية ↔ عملة رقمية - مبادلات مجمعة عبر السلاسل بأفضل الأسعار.

• جلب السلاسل — ما هي السلاسل النشطة
• جلب الرموز — الرموز مجمعة حسب السلسلة
• جلب الأسعار — أسعار مرجعية حية من Oracle
• الحصول على عرض سعر التبادل — أفضل عرض سعر مجمع عبر جميع مصادر السيولة
• إنشاء تبادل — قفل السعر والحصول على عنوان إيداع

3.2. الصفقة

عملة تقليدية ↔ عملة رقمية - نفس محرك التبادل، مع أصل تقليدي على أحد الجانبين.

• جلب العملات التقليدية — العملات التقليدية المتاحة
• الحصول على عرض سعر الصفقة — عرض من تقليدية إلى رقمية أو العكس
• إنشاء صفقة — قفل السعر والحصول على تعليمات الدفع

3.3. التاجر

مزود الدفع - اقبل المدفوعات في مشاريعك، اشحن العملاء بأي رمز واستلم رمزاً مختلفاً في محفظتك.

• إنشاء فاتورة — دفع برمجي
• إنشاء رابط فاتورة قابل للمشاركة — رمز QR / رابط
• الحصول على إحصائيات الشريك، التبادلات، الفواتير

4. الحالة

ما أطلقته في الخطوة 3 (التنفيذات)، تتعقبه بنفس الطريقة:

• التحقق من حالة التبادل — صفقة واحدة
• التحقق من حالة تبادلات متعددة — استعلام مجمع

5. اكسب الإيرادات

أضف opts.partner_id المعين إلى معرّف الشريك الخاص بك أو محفظتك المسجّلة على أي /exchange/rate أو /exchange/create (أو wallet_merchant في /invoice/create) لإسناد الصفقة إليك. تتراكم الإيرادات وفقًا لإعدادات الدفع الخاصة بك (تحويلات فورية لكل سلسلة إلى المحفظة أو سحوبات USDT مجدولة).

{
  // ...جسم طلبك المعتاد
  opts: { partner_id: "P3_YOURPARTNERID" }, 
}

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