Erstattungen von Beiträgen

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Einführung

Mithilfe der Monetarisierung kannst du Entwicklern Erstattungen für „Kauftransaktionen“ gewähren. Angenommen, Sie Sie sind Mobilfunkanbieter und bieten Entwicklern eine Zahlungs-API an, mit der sie ihren Abonnenten Kauf einer App oder von Inhalten innerhalb der App. Jedes Mal, wenn ein Abonnent die API verwendet ist es eine Kauftransaktion.

Kauftransaktionen können zu Erstattungen führen. Es kann z. B. sein, dass Inhalte nicht übermittelt werden, oder der Drittanbieter mit dem Kauf unzufrieden ist. In diesen Fällen kann der Entwickler eine Erstattung an den Drittanbieter vor. Bei der Monetarisierung kannst du eine entsprechende Erstattung vornehmen. Dies ist insbesondere bei Umsatzbeteiligungsplänen.

Angenommen, der Entwickler, der die Erstattung für den mobilen Abonnenten veranlasst hat, hat einen Umsatz API-Produkt gemeinsam nutzen können. Angenommen, der Entwickler soll im Rahmen des Plans 70% des Netto-/Bruttopreis der Kauftransaktion. Indem Sie eine Rückerstattung vornehmen, heben Sie die Kauftransaktion, d. h., du ziehen 70% von der für den Monat an den Entwickler fälligen Zahlung ab Zeitpunkt der Rückerstattung. Der Monat kann sich vom Monat unterscheiden, in dem der tatsächliche Kauftransaktion durchgeführt wurde.

Erstattung über die Classic Edge-Benutzeroberfläche posten (nur Edge für Private Cloud)

Sie können eine Erstattung für jede „erfolgreiche“ Kauftransaktion, d. h., bei der die API die dem Drittanbieter erfolgreich in Rechnung gestellt wurden und für die Sie noch keinen vollständigen Erstattung. Das Posten einer Erstattung führt zur Erstellung einer Erstattungstransaktion mit einem Elternteil Transaktions-ID, wobei die Transaktions-ID die ID der Kauftransaktion ist.

Sie können eine Erstattung in Höhe des vollen Betrags der ursprünglichen Kauftransaktion oder für Teilbetrag Du kannst auch mehrere Teilerstattungen vornehmen, aber den Gesamtbetrag der Erstattungen Der Betrag darf nicht über dem ursprünglichen Kaufbetrag liegen.

So übermitteln Sie eine Erstattung:

1. Wähle auf dem Tab „Monetarisierung“ die Option „Erstattungen“ aus.

   

   Die Seite „Erstattungen“ wird geöffnet.

   

2. Wählen Sie im Dropdown-Menü Abrechnungsmonat den Monat aus, in dem die Kauftransaktion durchgeführt wurde. stattfand. Klicken Sie dann auf + Erstattungen.

   Daraufhin wird eine Liste aller erfolgreichen Kauftransaktionen für die ausgewählte Monat.

   

   Sie können die Erstattungsliste nach dem Namen des Entwicklers filtern oder nach dem Transaktion.

   Wenn Sie nach Entwickler filtern möchten, wählen Sie den Entwickler aus dem Drop-down-Menü „Entwickler“ aus. Dieses zeigt nur eine Liste der Transaktionen an, die sich auf den ausgewählten Entwickler beziehen.

   

   Gib die ID des ursprünglichen Kaufs ein, um nach der Transaktions-ID zu filtern die Sie erstatten möchten. Dadurch wird die Transaktion für diese ID zurückgegeben.

   

3. Klicken Sie in den Zeilen für die Transaktionen, die Sie erstatten möchten, das Kästchen „Auswählen“ an.
4. Wählen Sie im Dropdown-Menü Art entweder Gesamt oder Teilweise aus.

   Wenn du „Gesamt“ auswählst, wird der Gesamtbetrag des Kaufs erstattet. Wenn Sie Teilweise. Ein Teil des Kaufbetrags wird erstattet.

   Wenn Sie Teilerstattung auswählen, geben Sie den Betrag der Teilerstattung in das Feld Betrag ein. Sie können wird nur bis zum Gesamtbetrag des Kaufs erstattet. Wenn Sie bereits einen Teil eine Rückerstattung erhalten möchten, können Sie nur einen Betrag eingeben, der über den verbleibenden Betrag des Kaufs hinausgeht. Wenn der Parameter für die ursprüngliche Kauftransaktion sowohl Brutto- als auch Nettopreise hat, müssen Sie auch angeben, ob es sich bei dem Teilbetrag, den Sie erstatten möchten, um einen Brutto- oder Nettobetrag handelt.

   

5. Klicken Sie auf Speichern , um die Rückerstattung zu bearbeiten (oder auf Abbrechen , um den Vorgang abzubrechen).

   Die Erstattung wird auf den Monat des ursprünglichen Kaufs gutgeschrieben, wenn der Abrechnungsmonat noch nicht abgelaufen ist. offen. Andernfalls wird die Erstattung auf das aktuelle Datum angewendet.

   Bei einer teilweisen Erstattung erfolgt die Erstattung in Höhe des Teilbetrags und der Umsatzbeteiligung. wird basierend auf dem Teil des Gesamtbetrags abgezogen. Im Im Beispiel oben beläuft sich der Teilbetrag auf 0, 50 ÷ 1, 12 = 45% des Bruttopreises. Es werden 45% der Umsatzbeteiligung des Entwicklers abgezogen.

In der Benutzeroberfläche prüfen, ob eine Erstattung erfolgt ist verarbeitet

Sie können feststellen, ob eine Erstattung verarbeitet wurde, indem Sie den Abrechnungsmonat oben auf der Seite auf der Seite „Erstattungen“. Dies ist der Monat des Kaufs, falls der Abrechnungsmonat noch offen ist, oder der Aktueller Monat, wenn der Abrechnungsmonat beendet ist. Daraufhin wird eine Liste aller Erstattungen angezeigt, veröffentlicht wurden.

Erstattung über die API anbieten

Wenn du eine Erstattung posten möchtest, sende eine POST-Anfrage an /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, Dabei steht {package_id} für die Identifizierung des API-Pakets, auf das die Erstattung angewendet wird. gilt.

Wenn Sie die Anfrage senden, müssen Sie folgende Abfrageparameter angeben:

• Die ID der Kauftransaktion, die erstattet wird.
• Der Umsatztyp (GROSS oder NET) der Kauftransaktion.
• Der Erstattungsbetrag.
• Ein Hinweis mit dem Grund für die Erstattung.

Optional können Sie ein API-Paket, an das die Erstattung gewährt wird, als URL-Parameter angeben. gilt.

Eine vollständige Liste der URL finden Sie unter Konfigurationseinstellungen für Erstattungen. Parameter, die Sie in einem Erstattungsantrag angeben können.

Mit der folgenden Anfrage wird beispielsweise eine Erstattung für eine Kauftransaktion veranlasst. Die Erstattung beträgt 50% des Bruttobetrags der Kauftransaktion.

$ 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

Die Antwort sollte in etwa so aussehen (nur ein Teil der Antwort wird angezeigt):

{
  "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"
}

Konfigurationseinstellungen für Erstattungen für die API

Die folgenden Abfrageparameter können in einem Erstattungsantrag angegeben werden:

Nächste Schritte

Erfahren Sie, wie Sie Monetarisierungsjobs planen und welche Jobs geplant sind automatisch unter Programm Monetarisierungsjobs.