Rekomi

مقدمة

Rekomi هي منصة لتتبّع وإدارة التسويق بالعمولة، مع تكامل أصلي مع Dodo Payments. يشارك المسوّق بالعمولة رابطًا، وتسجّل Rekomi النقرة. عندما يجري ذلك الزائر عملية شراء، ترسل Dodo Payments عملية البيع إلى Rekomi، التي تنسبها إلى المسوّق بالعمولة الصحيح. تحسب Rekomi العمولة وتدفعها إلى المسوّقين بالعمولة نيابةً عنك، في أكثر من 150 دولة، مع تضمين النماذج الضريبية. للاتصال، تلصق مفتاح API واحدًا من Dodo Payments مع صلاحية الكتابة في Rekomi. تتحقق Rekomi من المفتاح، وتنشئ نقطة نهاية webhook في حسابك على Dodo Payments، وتجلب سر توقيع نقطة النهاية. لا تحتاج إلى ملء نموذج webhook أو لصق أي شيء مرة أخرى في Dodo Payments.

تنسب Rekomi عملية بيع إلى مسوّق بالعمولة عندما يُكمل عميل مُحال عملية دفع لمرة واحدة، أو يبدأ اشتراكًا مدفوعًا، أو يدفع تجديدًا. وتسترد تلقائيًا العمولة عند حدوث عمليات ردّ الأموال والنزاعات.

آلية العمل

تستضيف Dodo Payments صفحة الدفع على نطاقها الخاص، لذلك ينتقل إحالة المسوّق بالعمولة إلى عملية البيع باعتبارها metadata لصفحة الدفع:

ينقر الزائر على رابط مسوّق بالعمولة ويصل إلى موقعك، حيث يخزّن برنامج Rekomi النصي الإحالة في متصفحه.
عند الدفع، تُرفق تلك الإحالة بالدفع باعتبارها rekomi_ref في metadata.
تعالج Dodo Payments عملية الدفع وترسل webhook موقّعًا payment.succeeded إلى نقطة النهاية التي أنشأتها Rekomi.
تطابق Rekomi الإحالة مع المسوّق بالعمولة، وتحسب العمولة على مبلغ البيع قبل الضريبة، وتسجّلها.

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

المتطلبات الأساسية

قبل إعداد هذا التكامل، تحتاج إلى:

حساب Dodo Payments في الوضع المباشر
حساب Rekomi
مفتاح API من Dodo Payments مع تفعيل صلاحية الكتابة، لأن المفاتيح للقراءة فقط لا يمكنها إنشاء webhooks

البدء

Create an API Key with Write Access

فعّل صلاحية الكتابة على المفتاح. يمرّ المفتاح للقراءة فقط من التحقق، لكنه لا يستطيع إنشاء نقطة نهاية webhook، لذلك يفشل الاتصال في منتصف العملية.

في لوحة تحكم Dodo Payments، انتقل إلى Developer → API Keys وانقر على Add API Key. سمِّ المفتاح Rekomi واترك خيار Enable write access محددًا. لمزيد من التفاصيل، راجع المصادقة.

Paste the Key into Rekomi

في Rekomi، افتح Setup → Connect payment processor، واختر Dodo Payments، ثم ألصق المفتاح. تتحقق Rekomi منه، وتنشئ نقطة نهاية webhook في حسابك، وتجلب سر توقيع نقطة النهاية.

صفحة إعداد Rekomi الخاصة بـ Dodo Payments، وبها حقل مفتاح API واحد وزر اتصال

بعد الاتصال، تستخدم Rekomi المفتاح فقط لإدارة نقطة نهاية webhook وإجراء فحوصات دورية لحالة النظام. تصل مبيعاتك عبر webhook الموقّع، وليس عبر API.

Install the Rekomi Script

أضف برنامج Rekomi النصي للتتبّع إلى موقعك التسويقي لالتقاط نقرات المسوّقين بالعمولة. تعرض Rekomi المقتطف البرمجي، مع ملء معرّف البرنامج، ضمن Setup → Install.

<script
  async
  src="https://api.rekomi.com/api/v1/r/loader.js"
  data-program-id="YOUR_PROGRAM_ID"
></script>

Pass the Referral into Checkout

أرفق الإحالة الملتقطة بكل دفعة باعتبارها rekomi_ref في metadata. يوضّح دليل التنفيذ الطريقة لكل نوع من أنواع الدفع.

Done

تُنسب الآن مبيعات وتجديدات وعمليات ردّ الأموال والنزاعات إلى عمولات المسوّقين بالعمولة، وتُسترد تلقائيًا، كما تدفع Rekomi مستحقات المسوّقين بالعمولة.

دليل التنفيذ

جلسات الدفع عبر API

في الواجهة الأمامية، اقرأ الإحالة باستخدام window.Rekomi.getReferral() وأرسلها إلى الواجهة الخلفية مع طلب الدفع. وفي الواجهة الخلفية، عيّنها في metadata:

Node.js

import DodoPayments from 'dodopayments';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
const client = new DodoPayments();

export async function createCheckout(productId: string, rekomiRef?: string) {
  const session = await client.checkoutSessions.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    return_url: 'https://yoursite.com/success',
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return session.checkout_url;
}

يعمل الحقل metadata.rekomi_ref نفسه مع منتجات الاشتراكات، لذلك تنسب الدفعة الأولى وكل تجديد إلى المسوّق بالعمولة نفسه.

Payments API

يستخدم المثال أدناه POST /payments، وهو مهمل. ولا يزال يعمل مع عمليات التكامل الحالية. ينبغي لعمليات التكامل الجديدة استخدام Checkout Sessions (POST /checkouts)، التي تتلقى metadata بالطريقة نفسها.

Node.js

import DodoPayments from 'dodopayments';

// Reads DODO_PAYMENTS_API_KEY from the environment and defaults to live mode.
const client = new DodoPayments();

export async function createPayment(productId: string, rekomiRef?: string) {
  const payment = await client.payments.create({
    billing: {
      city: 'New York',
      country: 'US',
      state: 'NY',
      street: '123 Main St',
      zipcode: '10001',
    },
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    product_cart: [{ product_id: productId, quantity: 1 }],
    payment_link: true,
    metadata: {
      ...(rekomiRef ? { rekomi_ref: rekomiRef } : {}),
    },
  });

  return payment;
}

روابط الدفع الثابتة

أضف الإحالة إلى الرابط باعتبارها معلمة استعلام مسطحة metadata_rekomi_ref، وليس بصيغة الأقواس:

const ref = window.Rekomi?.getReferral?.();
let url = 'https://checkout.dodopayments.com/buy/YOUR_PRODUCT_ID';
if (ref) url += `?metadata_rekomi_ref=${encodeURIComponent(ref)}`;
// use url as the href on your Buy button

تضيف Dodo Payments معلمات الاستعلام metadata_* إلى metadata الخاصة بالدفع، حيث تقرؤها Rekomi.

ما يتم تتبّعه

تتعامل Rekomi مع كل نوع من أحداث البيع كما يلي:

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

تحسب Rekomi العمولات على مبلغ البيع قبل الضريبة. Dodo Payments هي Merchant of Record وتحصّل الضريبة، لذلك يكسب المسوّقون بالعمولة من عملية البيع نفسها، وليس من الضريبة التي تضيفها دولة المشتري.

ملاحظات مهمة

تسجّل Rekomi نقطة نهاية webhook بالأحداث التي تحتاج إليها بالضبط. لا تعدّل قائمة أحداث نقطة النهاية تلك في لوحة تحكم Dodo Payments، إذ تشير فحوصات حالة Rekomi إلى وجود مشكلة في الاتصال إذا أزيلت أي أحداث.
لا ينشئ الإصدار التجريبي المجاني أي دفعة حتى ينتهي الإصدار التجريبي، لذلك لا توجد عمولة حتى يتم تحصيل الرسم الأول. أما الإصدار التجريبي المدفوع فيحصّل مبلغ الإصدار التجريبي مقدمًا.
يؤدي قطع الاتصال في Rekomi إلى حذف نقطة نهاية webhook من حسابك على Dodo Payments.

موارد إضافية

Rekomi's Dodo Payments Guide

جولة الإعداد الكاملة، واستكشاف الأخطاء وإصلاحها، وتفاصيل الأمان في مستندات Rekomi.

Affiliates Feature Guide

جميع خيارات تكامل التسويق بالعمولة مع Dodo Payments.

للحصول على المساعدة بشأن التكامل، تواصل مع دعم Rekomi عبر support@rekomi.com، أو مع دعم Dodo Payments عبر support@dodopayments.com.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

مقدمة

آلية العمل

المتطلبات الأساسية

البدء

دليل التنفيذ

جلسات الدفع عبر API

Payments API

روابط الدفع الثابتة

ما يتم تتبّعه

ملاحظات مهمة

موارد إضافية

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

​مقدمة

​آلية العمل

​المتطلبات الأساسية

​البدء

​دليل التنفيذ

​جلسات الدفع عبر API

​Payments API

​روابط الدفع الثابتة

​ما يتم تتبّعه

​ملاحظات مهمة

​موارد إضافية

Rekomi's Dodo Payments Guide

Affiliates Feature Guide

مقدمة

آلية العمل

المتطلبات الأساسية

البدء

دليل التنفيذ

جلسات الدفع عبر API

Payments API

روابط الدفع الثابتة

ما يتم تتبّعه

ملاحظات مهمة

موارد إضافية