Bu sayfa, Cloud Translation API ile çevrilmiştir.

Geri ödeme yayınlama

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Giriş

Para kazanma özelliği, "satın alma işlemleri" için geliştiricilere geri ödeme yapmanıza olanak tanır. Mobil operatör olduğunuzu ve geliştiricilere uygulama veya içerik satın alma karşılığında mobil abonelerden ödeme almaları için bir ödeme API'si sunduğunuzu varsayalım. Abonelerin API'yi kullanarak yaptıkları her satın alma işlemi bir satın alma işlemidir.

Satın alma işlemleri geri ödemeyle sonuçlanabilir. Örneğin, içerik yayınlanmayabilir veya üçüncü taraf, satın alma işleminden memnun kalmamış olabilir. Bu durumlarda, geliştirici üçüncü tarafa geri ödeme yapar. Para kazanma özelliği sayesinde benzer şekilde geri ödeme yapabilirsiniz. Bu, özellikle gelir paylaşımı planları için geçerlidir.

Mobil aboneye geri ödemeyi yapan geliştiricinin API ürününüz için bir gelir paylaşımı planı satın aldığını düşünün. Planın, geliştiriciye satın alma işleminin net/brüt fiyatının% 70'ini almasını istediğini varsayalım. Bir geri ödeme gönderdiğinizde, aslında satın alma işlemini geri almış olursunuz. Yani, geri ödemenin yapıldığı ay (gerçek satın alma işleminin gerçekleştiği aydan farklı olabilir) geliştiriciye ödenecek tutardan% 70 düşülür.

Klasik Edge kullanıcı arayüzünü kullanarak geri ödeme yayınlama (yalnızca Private Cloud için Edge)

API'nin üçüncü taraftan başarılı bir şekilde ödeme aldığı ve henüz tam geri ödeme yapmadığınız herhangi bir "başarılı" satın alma işlemi için geri ödeme yayınlayabilirsiniz. Geri ödeme yayınlandığında, üst işlem kimliği ile geri ödeme işlemi oluşturulur. Burada işlem kimliği, satın alma işleminin kimliğidir.

Orijinal satın alma işleminin tam tutarı veya kısmi bir tutar için geri ödeme yayınlayabilirsiniz. Birden çok kısmi geri ödeme de gönderebilirsiniz ancak geri ödemelerin toplam tutarı, orijinal satın alma tutarından fazla olamaz.

Geri ödeme yayınlamak için:

Para kazanma sekmesinde Geri ödemeler'i seçin.

Geri ödemeler sayfası açılır.
Faturalandırma Ayı açılır menüsünde, satın alma işleminin gerçekleştiği ayı seçin. Ardından + Geri ödemeler'i tıklayın.
Seçilen ayda başarılı olan tüm satın alma işlemlerinin listesini gösterir.

Geri ödeme listesini geliştirici adına veya gerçek işlemde arama yaparak filtreleyebilirsiniz.

Geliştiriciye göre filtrelemek için Geliştirici açılır menüsünden geliştiriciyi seçin. Bu işlemle, yalnızca seçilen geliştiriciyle ilgili işlemlerin bir listesi gösterilir.

İşlem kimliğine göre filtrelemek için geri ödeme yapmak istediğiniz orijinal satın alma işleminin işlem kimliğini girin. Bu işlem, söz konusu kimliğe ilişkin işlemi döndürür.
Geri ödeme yapmak istediğiniz işlemler için satırlardaki Seç kutusunu işaretleyin.
Tür açılır menüsünden Toplam veya Kısmi seçeneğini belirleyin.
Toplam'ı seçerseniz satın alma işleminin toplam tutarı geri ödenir. Kısmi'yi seçerseniz satın alma işleminin bir kısmı geri ödenir.

Kısmi seçeneğini belirlerseniz, Tutar alanına kısmi geri ödeme tutarını girin. Yalnızca toplam satın alma tutarı kadar geri ödeme yapabilirsiniz. Halihazırda kısmi geri ödeme yayınladıysanız en fazla satın alma işleminin kalan tutarını girebilirsiniz. Ayrıca, orijinal satın alma işlemi hem brüt hem de net fiyatlara sahipse geri ödemek istediğiniz kısmi tutarın brüt veya net olduğunu da belirtmeniz gerekir.
Geri ödemeyi işlemek için Kaydet'i (veya iptal etmek için İptal'i) tıklayın.
Faturalandırma ayı hâlâ açıksa geri ödeme, orijinal satın alma işleminin yapıldığı ayda gönderilir. Aksi takdirde, geçerli tarihe geri ödeme yapılır.

Kısmi geri ödeme söz konusu olduğunda, geri ödeme kısmi tutar için işleme alınır ve gelir paylaşımı kısmi tutarın tam tutara oranına göre düşülür. Yukarıdaki kısmi geri ödeme örneğinde kısmi tutar 0, 50/1, 12 = brüt fiyatın% 45'idir. Bu nedenle geliştiricinin gelir payının% 45'i düşülür.

Geri ödemenin işlenip işlenmediğini kullanıcı arayüzünden kontrol etme

Geri ödemeler sayfasının üst kısmındaki faturalandırma ayını seçerek geri ödemenin işlenip işlenmediğini belirleyebilirsiniz. Bu, faturalandırma ayı hâlâ açıksa satın alma ayıdır. Faturalandırma ayı kapalıysa içinde bulunulan aydır. Bu, o ay yapılan tüm geri ödemelerin listesini gösterir.

API'yi kullanarak geri ödeme yayınlama

Geri ödeme yayınlamak için /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions adresine bir POST isteği gönderin. Burada {package_id}, geri ödemenin geçerli olduğu API paketinin kimliğidir.

İsteği gönderdiğinizde, sorgu parametreleri olarak belirtmeniz gerekir:

Geri ödeme yapılan satın alma işleminin kimliği.
Satın alma işleminin gelir türü (GROSS veya NET).
Geri ödeme tutarı.
Geri ödeme nedenini açıklayan bir not.

İsteğe bağlı olarak, geri ödemenin geçerli olduğu bir API paketini URL parametresi olarak tanımlayabilirsiniz.

Geri ödeme isteğinde belirtebileceğiniz URL parametrelerinin tam listesi için Geri ödeme yapılandırma ayarları bölümüne bakın.

Örneğin, aşağıdaki istek, bir satın alma işlemi için geri ödeme yapar. Geri ödeme tutarı, satın alma işleminin brüt tutarının% 50'sidir.

$ 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

Yanıt aşağıdaki gibi görünmelidir (yanıtın yalnızca bir kısmı gösterilir):

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

API için geri ödeme yapılandırma ayarları

Geri ödeme isteğinde aşağıdaki sorgu parametreleri belirtilebilir:

Ad	Açıklama	Varsayılan	Zorunlu mu?
`monetizationPackageId`	Geri ödemenin geçerli olduğu API paketi.	Yok	Hayır
`parentTxId`	Geri ödenecek satın alma işlemi.	Yok	Evet
`revenueType`	Satın alma işleminin gelir türü (`GROSS` veya `NET`).	Yok	Evet
`refundAmount`	Geri ödeme tutarı.	Yok	Evet
`transactionNote`	Geri ödeme nedenini açıklayan bir metin notu.	Yok	Evet

Sonraki adımlar

Para kazanma işlerini planlama bölümünden para kazanmayla ilgili işleri nasıl planlayacağınızı ve otomatik olarak planlanan işler hakkında bilgi edinin.