SMSBulk
العودة إلى التوثيق
برنامج شركاء واجهة برمجة التطبيقات

واجهة برمجة الإحالة (ref_id)

أضف ref_id إلى أي طلب شراء واربح حصة من الإيرادات عند اعتماد التفعيل.

كيف يعمل

آلية كل مكافأة ref_id.

تربح 5% من إيرادات كل تفعيل معتمد يحمل ref_id الخاص بك. استثناء واحد: إذا كان ربح العملية منخفضًا جدًا، تقتصر المكافأة على جزء من ذلك الربح. لم يُطبَّق هذا الحد حتى الآن.

تُنشأ المكافأة فقط عند اعتماد التفعيل، أي عند وصول رمز التحقق فعلًا. التفعيل الملغى أو المسترد لا يحقق أي أرباح.

تُضاف المكافآت إلى رصيد محفظتك فورًا دون فترة انتظار.

أرباح API هي رصيد في المحفظة: لا يوجد حد أدنى ولا طلب سحب، لكن لا يمكن تحويلها إلى نقد. أنفقها على أي منتج في المنصة.

إرسال ref_id

يقبل كلا مساري واجهة برمجة التطبيقات نفس رمز الإحالة، ويختلف فقط أسلوب النقل.

الواجهة الحديثة (v1، جسم JSON)

curl -X POST "https://smsbulk.net/api/v1/activations" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "US",
    "ref_id": "K7M2QXWP"
  }'
{
  "id": "act_9f1c...",
  "status": "PENDING",
  "phoneNumber": "+1...",
  "referral": {
    "accepted": true,
    "reason": null
  }
}

المسار المتوافق مع SMS-Activate (معامل طلب)

curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getNumber&service=wa&country=187&ref_id=K7M2QXWP"
ACCESS_NUMBER:12345678:79991234567

القاعدتان الأكثر التباسًا لدى الشركاء

تحمي هاتان القاعدتان البرنامج من الدفع الذاتي والدفع المزدوج. إذا لم تظهر المكافأة، فالسبب غالبًا إحداهما.

يُمنع الدفع الذاتي

إذا كان ref_id يخص نفس الحساب الذي يقوم بالشراء، فلا تُنشأ أي مكافأة. وضع ref_id الخاص بك على حركة مرورك الخاصة لا يحقق عمولة أبدًا.

الحسابات المرتبطة مسبقًا تُتجاهل

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

ref_id غير الصالح لا يوقف عملية الشراء أبدًا

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

حقل referral في استجابة v1

تتضمن POST /v1/activations كائن referral فقط إذا أرسل الطلب نفسه ref_id. الطلبات التي لا ترسله تحصل على نفس شكل الاستجابة تمامًا كما كان سابقًا.

  • accepted: true تعني أن ref_id تم قبوله وربطه بهذا التفعيل. أما المكافأة نفسها فتُسجَّل لاحقًا عند اعتماد التفعيل.
  • accepted: false تعني أنه لم تُنشأ أي مكافأة؛ راجع قيمة reason أدناه.

قيم reason

reasonالمعنى
unknown_coderef_id لا يطابق رمز أي شريك. محاولات التخمين المتكررة مقيدة بمعدل.
self_dealingref_id يخص نفس الحساب الذي قام بالشراء.
already_referredالمشتري مرتبط بالفعل بهذا الشريك نفسه منذ التسجيل، لذلك يُتجاهل الرمز ولا يُعامل كخطأ.
referrer_inactiveحساب الشريك خلف هذا ref_id غير نشط أو محظور.

المسار المتوافق مع SMS-Activate لا يحتوي على حقل referral

يعيد هذا البروتوكول سطر نص عادي مثل ACCESS_NUMBER:id:phoneNumber وليس JSON، لذا لا يوجد حقل لنقل نتيجة accepted/reason. يعمل ref_id بنفس الطريقة تمامًا على هذا المسار، لكنك لن ترى النتيجة في الاستجابة. تحقق من لوحة الشركاء للتأكيد بدلًا من ذلك.

ابدأ الربح من حركة مرور واجهة برمجة التطبيقات الخاصة بك

احصل على رمز الإحالة الخاص بك من لوحة الشركاء وأضفه إلى تكاملك.

افتح لوحة الشركاءالعودة إلى التوثيق