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 göndermenize olanak tanır. Bir mobil operatör olduğunuzu ve geliştiricilere, mobil abonelerden uygulama veya uygulama içindeki içerik satın alma işlemleri için ödeme almak üzere bir ödeme API'si sunduğunuzu varsayalım. Abonelerin API'yi kullanarak yaptığı her satın alma işlemi, satın alma işlemi olarak kabul edilir.

Satın alma işlemleri geri ödemeyle sonuçlanabilir. Örneğin, içerik teslim edilmemiş olabilir veya üçüncü taraf satın alma işleminden memnun kalmamış olabilir. Bu tür durumlarda geliştirici, üçüncü tarafa geri ödeme yapar. Para kazanma özelliği, benzer bir geri ödeme yapmanıza olanak tanır. Bu durum özellikle gelir paylaşımı planları için geçerlidir.

Mobil aboneye geri ödeme yapan geliştiricinin, API ürününüz için gelir paylaşımı planı satın aldığını varsayalım. Plana göre, geliştiricinin satın alma işleminin net/brüt fiyatının% 70'ini alacağını varsayalım. Geri ödeme yayınlayarak satın alma işlemini geri almış olursunuz. Yani, geri ödemenin uygulandığı ayda (bu ay, satın alma işleminin gerçekleştiği aydan farklı olabilir) geliştiriciye ödenmesi gereken tutardan% 70'i düşersiniz.

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

API'nin üçüncü taraftan başarıyla ödeme aldığı ve henüz eksiksiz geri ödeme yapmadığınız tüm "başarılı" satın alma işlemleri için geri ödeme yayınlayabilirsiniz. Geri ödeme yayınlandığında, üst işlem kimliği olan bir geri ödeme işlemi oluşturulur. İşlem kimliği, satın alma işlemi kimliğidir.

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

Geri ödeme yayınlamak için:

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

   

   Geri ödemeler sayfası açılır.

   

2. 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.

   Bu raporda, seçilen aya ait tüm başarılı satın alma işlemlerinin listesi gösterilir.

   

   Geri ödeme listesini geliştirici adına göre filtreleyebilir veya gerçek işlemi arayarak filtreleyebilirsiniz.

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

   

   İş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 ait işlemi döndürür.

   

3. Geri ödeme yapmak istediğiniz işlemlerin satırlarında Seç kutusunu işaretleyin.
4. Tür açılır menüsünde Toplam veya Kısmi'yi seçin.

   Toplam'ı seçerseniz satın alma işleminin toplam tutarı geri ödenir. Kısmi'yi seçerseniz satın alma işleminin kısmi tutarı geri ödenir.

   Kısmi'yi seçerseniz Kısmi geri ödeme tutarı alanına kısmi geri ödeme tutarını girin. Yalnızca satın alma işleminin toplam tutarına kadar geri ödeme yapabilirsiniz. Kısmi geri ödeme yayınladıysanız yalnızca satın alma işleminde kalan tutara kadar bir tutar girebilirsiniz. Ayrıca, orijinal satın alma işleminde hem brüt hem de net fiyat varsa geri ödemek istediğiniz kısmi tutarın brüt mü yoksa net mi olduğunu da belirtmeniz gerekir.

   

5. Geri ödemeyi işleme almak için Kaydet'i (veya iptal etmek için İptal'i) tıklayın.

   Fatura ayı hâlâ açıksa geri ödeme, orijinal satın alma işleminin yapıldığı aya gönderilir. Aksi takdirde geri ödeme, geçerli tarihe gönderilir.

   Kısmi geri ödeme durumunda, geri ödeme kısmi tutar için işlenir ve gelir paylaşımı, kısmi tutarın tam tutara oranı temel alınarak düşülür. Yukarıdaki kısmi geri ödeme örneğinde, kısmi tutar 0,50/1,12 = brüt fiyatın% 45'i olduğundan geliştiricinin gelir payının% 45'i düşülür.

Geri ödemenin işleme alınıp alınmadığını kullanıcı arayüzünde kontrol etme

Geri ödemenin işlenip işlenmediğini belirlemek için Geri Ödemeler sayfasının üst kısmından fatura ayını seçebilirsiniz. Faturalandırma ayı hâlâ açıksa satın alma işleminin yapıldığı ay, faturalandırma ayı kapalıysa geçerli ay. Bu bölümde, ilgili ayda gönderilen tüm geri ödemelerin listesi gösterilir.

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önderirken sorgu parametreleri olarak şunları belirtmeniz gerekir:

• Geri ödemesi yapılan satın alma işleminin tanımlayıcısı.
• 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 belirleyebilirsiniz.

Geri ödeme isteğinde belirtebileceğiniz URL parametrelerinin tam listesi için Geri ödeme yapılandırma ayarları başlıklı makaleyi inceleyin.

Örneğin, aşağıdaki istek, satın alma işlemi için geri ödeme yapar. Geri ödeme tutarı, satın alma işlemi 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österilmektedir):

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

Sonraki adımlar

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