Geri ödeme yayınlama

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Giriş

Para kazanma, "satın alma işlemleri" için geliştiricilere geri ödeme göndermenize olanak tanır. Diyelim ki bir mobil operatörseniz ve geliştiricilere, mobil abonelerden ödeme almaları için bir uygulama veya uygulama içindeki içeriğin satın alınması. Bir abone API'yi her kullandığında satın alma işlemi, satın alma işlemidir.

Satın alma işlemleri geri ödemeyle sonuçlanabilir. Örneğin, içerik teslim edilmeyebilir. veya üçüncü taraf, satın alma işleminden memnun kalmazsa Böyle durumlarda geliştirici, üçüncü tarafa geri ödeme yapar. Para kazanma, benzer bir geri ödeme yapmanıza olanak tanır. Bu özellikle de gelir paylaşımı planlarıyla ilgilidir.

Mobil aboneye geri ödeme yapan geliştiricinin bir gelir satın aldığını varsayın paylaşın. Plana göre, geliştiriciye gösterilen trafiğin% 70'ini satın alma işleminin net/brüt fiyatı. Geri ödeme göndererek, aslında başka bir deyişle, geliştiriciye ay için ödenecek ödemeden% 70 oranında kesinti geri ödemenin uygulandığı ay (ay, fiili tutarın gönderildiği aydan farklı olabilir) satın alma işleminin gerçekleştirildiği anlamına gelir.)

Classic Edge kullanıcı arayüzünü kullanarak geri ödeme yayınlama (yalnızca Edge for Private Cloud)

Her "başarılı" sonuç için geri ödeme gönderebilirsiniz işlemidir (yani API, ödeme almadığınız ve henüz tam ödeme yapmadığınız için geri ödeme. Geri ödeme yayınlandığında ebeveynle geri ödeme işlemi oluşturulur işlem kimliği (işlem kimliği, satın alma işleminin kimliğidir).

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

Geri ödeme yapmak 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 gerçekleştirilmiştir. Ardından + Geri ödemeler'i tıklayın.

   Bu, seçilen kampanya için tüm başarılı satın alma işlemlerinin listesini gösterir. ay.

   

   Geri ödeme listesini geliştirici adına göre veya gerçek belirtir.

   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 yaptığınız orijinal satın alma işleminin işlem kimliğini girin. geri ödeme almak istiyorum. Bu, söz konusu kimlik için işlemi döndürür.

   

3. Geri ödeme yapmak istediğiniz işlemler için satırlardaki Seç kutusunu işaretleyin.
4. Tür açılır menüsünde Toplam veya Kısmi seçeneğini belirleyin.

   Toplam'ı seçerseniz satın alma işleminin toplam tutarı geri ödenir. Seçim Kısmi olarak, satın alma işleminin bir kısmı geri ödenir.

   Kısmi'i seçerseniz, Tutar alanına kısmi geri ödeme tutarını girin. Şunları yapabilirsiniz: yalnızca satın alma işleminin toplam tutarına kadar geri ödeme yapabilirsiniz. Halihazırda kısmi bir geri ödeme için, yalnızca satın alma işleminde kalan tutara kadar bir tutar girebilirsiniz. Ayrıca, orijinal satın alma işleminin hem brüt hem de net fiyatları olduğundan, Geri ödeme yapmak istediğiniz kısmi tutarın brüt mü yoksa net mi olduğunu girin.

   

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

   Faturalandırma ayı hâlâ geçerliyse geri ödeme, satın alma işleminin yapıldığı ayda gönderilir. açık, aksi takdirde geri ödeme geçerli tarihe kadar işlenecektir.

   Kısmi geri ödemede geri ödeme, kısmi tutar ve gelir paylaşımı için işleme alınır. kısmi tutarın tam tutar üzerindeki oranına göre düşülür. yukarıdaki kısmi geri ödeme örneği, kısmi tutar 0,50/1,12 = brüt fiyatın% 45'idir. Geliştiricinin gelir payının% 45'i düşülür.

Kullanıcı arayüzünde geri ödemenin yapılıp yapılmadığını kontrol etme işlendi

Sayfanın üst kısmından faturalandırma ayını seçerek geri ödemenin işleme alınıp alınmadığını belirleyebilirsiniz Geri ödemeler sayfasını ziyaret edin. Bu, faturalandırma ayı hâlâ açıksa satın almanın yapıldığı aydır. fatura ayı kapalıysa geçerli ay. Yapılan geri ödemelerin listesi, ay içinde yayınlandı.

API'yi kullanarak geri ödeme yayınlama

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

İsteği gönderirken 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 gönderildiği bir API paketini URL parametresi olarak tanımlayabilirsiniz. geçerli olur.

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

Ö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'si kadardır.

$ 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ünecektir (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:

Sonraki adımlar

Para kazanmayla ilgili işleri ve planlanmış işleri nasıl planlayacağınızı öğrenin Programa otomatik olarak para kazanma alanındaki iş ilanları.