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

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

مقدمة

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

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

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

نشر رد الأموال باستخدام واجهة مستخدم Edge الكلاسيكي (Edge for Private Cloud فقط)

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

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

لنشر ردّ الأموال:

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) لمعاملة الشراء.
• المبلغ المردود
• ملاحظة توضّح سبب ردّ الأموال.

يمكنك اختياريًا الإشارة إلى حزمة واجهة برمجة التطبيقات (API) التي يتم ردّ الأموال إليها باعتبارها مَعلمة عنوان 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"
}

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

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

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

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