ردّ أموال المشاركات

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

مقدمة

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

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

لنفترض أنّ المطوّر الذي أصدر ردّ الأموال إلى المشترك على الأجهزة الجوّالة قد اشترى خطة حصة أرباح لمنتج واجهة برمجة التطبيقات الخاص بك. لنفترض أنّ الخطة تطلب من مطوّر البرامج تلقّي% 70 من صافي/إجمالي السعر لمعاملة الشراء. عند ردّ الأموال، أنت في الواقع تُلغي معاملة الشراء، بمعنى أنّك ستخصم 70% من الدفعة المستحقة للمطوّر عن الشهر الذي تمّ فيه ردّ الأموال (قد يكون الشهر مختلفًا عن الشهر الذي تمّت فيه معاملة الشراء الفعلية).

نشر ردّ الأموال باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge (ميزة Edge في السحابة الإلكترونية الخاصة فقط)

يمكنك ردّ الأموال المدفوعة مقابل أي معاملة شراء "ناجحة"، أي عندما تنجح واجهة برمجة التطبيقات في تحصيل الرسوم من الجهة الخارجية ولم يتم ردّ الأموال بالكامل لها. يؤدّي نشر طلب ردّ الأموال إلى إنشاء معاملة ردّ الأموال باستخدام معرِّف معاملة رئيسي، حيث يكون معرِّف المعاملة هو معرِّف معاملة الشراء.

يمكنك ردّ المبلغ الكامل الذي دفعته في معاملة الشراء الأصلية أو ردّ جزء من الأموال. يمكنك أيضًا نشر عدة عمليات ردّ جزء من الأموال، ولكن لا يمكن أن يتخطى المبلغ الإجمالي لعمليات ردّ الأموال مبلغ الشراء الأصلي.

لنشر عملية ردّ أموال:

  1. ضمن علامة التبويب "تحقيق الربح"، اختَر "ردّ الأموال".

    يؤدي ذلك إلى فتح صفحة "عمليات استرداد الأموال".

  2. في "شهر الفوترة"، اختَر الشهر الذي أجريت فيه معاملة الشراء. ثم انقر على "+ استرداد الأموال".

    يعرض هذا العمود قائمة بجميع معاملات الشراء الناجحة للشهر المحدّد.

    يمكنك فلترة قائمة عمليات ردّ الأموال حسب اسم المطوّر أو من خلال البحث عن المعاملة الفعلية.

    للفلترة حسب المطوّر، اختَره من القائمة المنسدلة "مطوّر البرامج". ويعرض هذا قائمة بالمعاملات ذات الصلة بمطوّر البرامج المحدد فقط.

    للفلترة حسب معرِّف المعاملة، أدخِل معرِّف المعاملة لعملية الشراء الأصلية التي تريد استرداد أموالها. وسيؤدي هذا الإجراء إلى إرجاع المعاملة لهذا المعرّف.

  3. حدد مربع الاختيار في الصف (الصفوف) للمعاملات التي تريد رد أموالها.
  4. حدد إما الإجمالي أو جزئي في القائمة المنسدلة النوع.

    إذا اخترت "الإجمالي"، سيتم ردّ إجمالي مبلغ عملية الشراء. إذا اخترت "جزئي"، سيتم ردّ جزء من المبلغ الذي دفعته مقابل عملية الشراء.

    إذا حددت "جزئي"، فأدخل مبلغ استرداد جزء من الأموال في الحقل "المبلغ". يمكنك استرداد مبلغ تصل قيمته إلى إجمالي مبلغ عملية الشراء فقط. إذا سبق أن طلبت استرداد جزء من الأموال، لا يمكنك سوى إدخال مبلغ يصل إلى المبلغ المتبقّي في عملية الشراء. بالإضافة إلى ذلك، إذا كانت معاملة الشراء الأصلية تتضمّن سعرًا إجماليًا وصافيًا، عليك أيضًا تحديد ما إذا كان المبلغ الجزئي الذي تريد ردّه هو إجمالي المبلغ أو صافيه.

  5. انقر على "حفظ" لمعالجة عملية ردّ الأموال (أو "إلغاء" للإلغاء).

    يتم نشر عملية ردّ الأموال في شهر عملية الشراء الأصلية إذا كان شهر الفوترة لا يزال مفتوحًا، وإلا سيتم نشر المبلغ المردود في التاريخ الحالي.

    بالنسبة إلى عملية ردّ جزء من الأموال، تتمّ معالجة عملية ردّ الأموال بجزء من المبلغ، ويتم خصم أي حصة أرباح استنادًا إلى نسبة المبلغ الجزئي عن المبلغ الكامل. في مثال ردّ جزء من الأموال أعلاه، يكون المبلغ الجزئي 0.50/1.12 = 45% من السعر الإجمالي، لذلك سيتم خصم 45% من حصة أرباح المطوّر.

التحقق في واجهة المستخدم مما إذا تمت معالجة عملية ردّ الأموال

يمكنك معرفة ما إذا تمّت معالجة عملية ردّ الأموال عن طريق اختيار شهر الفوترة في أعلى صفحة "عمليات ردّ الأموال". هذا هو شهر الشراء إذا كان شهر الفوترة لا يزال مفتوحًا، أو الشهر الحالي إذا كان شهر الفوترة مغلقًا. يعرض هذا العمود قائمة بجميع عمليات ردّ الأموال التي تمت خلال هذا الشهر.

نشر ردّ أموال باستخدام واجهة برمجة التطبيقات

لنشر طلب استرداد الأموال، يمكنك إرسال طلب POST إلى /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions، حيث يشير الرمز {package_id} إلى تعريف حزمة واجهة برمجة التطبيقات التي تنطبق عليها عملية ردّ الأموال.

عند إصدار الطلب، عليك تحديد مَعلمات طلب البحث التالية:

  • تحديد معاملة الشراء التي يتم ردّ أموالها
  • نوع الأرباح (GROSS أو NET) لمعاملة الشراء
  • المبلغ الذي تم ردّه.
  • ملاحظة توضّح سبب ردّ الأموال:

يمكنك اختياريًا تحديد حزمة واجهة برمجة التطبيقات التي ينطبق عليها ردّ الأموال كمَعلمة عنوان URL.

راجِع إعدادات ضبط ردّ الأموال للحصول على قائمة كاملة بمَعلمات عناوين URL التي يمكنك تحديدها في طلب ردّ الأموال.

على سبيل المثال، يؤدي الطلب التالي إلى إصدار ردّ أموال معاملة شراء. ويبلغ المبلغ المردود% 50 من إجمالي مبلغ معاملة الشراء.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

يجب أن يبدو الرد على النحو التالي (يتم عرض جزء فقط من الرد):

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

إعدادات ضبط ردّ الأموال لواجهة برمجة التطبيقات

يمكن تحديد مَعلمات طلب البحث التالية في طلب ردّ الأموال:

الاسم الوصف تلقائي مطلوب؟
monetizationPackageId

حزمة واجهة برمجة التطبيقات التي ينطبق عليها ردّ الأموال.

لا ينطبق لا
parentTxId

معاملة الشراء التي سيتم ردّ أموالها

لا ينطبق نعم
revenueType

نوع الأرباح (GROSS أو NET) لمعاملة الشراء.

لا ينطبق نعم
refundAmount

المبلغ الذي تم ردّه.

لا ينطبق نعم
transactionNote

ملاحظة نصية توضح سبب ردّ الأموال.

لا ينطبق نعم

الخطوات التالية

اطّلِع على كيفية جدولة المهام المرتبطة بتحقيق الربح وعلى الوظائف التي يتم تحديد موعدها تلقائيًا في القسم جدولة المهام لتحقيق الربح.