Para Kazanma Sorunlarını Giderme

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

Bu konuda, sık karşılaşılan para kazanma sorunlarını giderme hakkında bilgi ve rehberlik sağlanmaktadır.

Geliştirici askıya alındı

Belirti

Geliştiricinin hesabı askıya alınır ve ek para kazanma işlemleri/API çağrıları yapamaz.

Hata mesajları

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

Teşhis

Geliştiricinin askıya alınma nedenini belirlemek için aşağıdaki adımları uygulayın:

  1. Askıya alınmış geliştiriciyle ilişkili hata kodunu belirlemek için aşağıdaki API çağrısını yürütün:
    1. Herkese açık bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. Özel bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. Geliştiricinin neden askıya alındığını belirlemek için hata kodunu aşağıdaki neden kodlarıyla karşılaştırın.

Ayrıca: Askıya alınan geliştiriciler için neden kodlarının özeti

Neden Kodu

Neden

Ayrıntılar

YETERSİZ_BAKİYE

Geliştirici hesabı bakiyesi tükendi

Ön ödemeli geliştirici hesabı bakiyesinde ek işlemler için yeterli bakiye yoksa geliştiricinin hesabı askıya alınır.

Faturalı ödeme yapan geliştiriciler için bu hata, kredi limitlerinin aşılması veya kullanılan para biriminde belirlenen kredi limitinin tükenmesi durumunda oluşabilir.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Geliştirici başka işlem yapamaz.

Her geliştirici, satın alınan tarife planına göre sabit sayıda işlem yapabilir. İşlem sayısı aşılırsa geliştiricinin hesabı askıya alınır ve ek işlemler tamamlayamaz.

NO_CURRENT_PUBLISHABLE_ENTITY

Geliştirici herhangi bir ücret planı satın almadı

Geliştiriciler, herhangi bir işlemi tamamlamadan önce bir ücret planı satın almalıdır.

Çözünürlük

Hata

Çözüm adımları

YETERSİZ_BAKİYE

Geliştiricinin, ek işlemleri tamamlamak için yeterli hesap bakiyesi veya kullanılabilir kredi olduğundan emin olması gerekir.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

  1. Geliştirici fiyat planını ve işlem ayrıntılarını almak için sırasıyla aşağıdaki API çağrılarını yapın:
    • Geliştiricinin satın aldığı ücret planlarının başlangıç ve bitiş tarihini almak için aşağıdaki API çağrısını çalıştırın:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
      
    • Geliştiricinin yaptığı başarılı işlemlerin sayısını almak için aşağıdaki API çağrısını çalıştırın:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D
      
  2. Edge kullanıcı arayüzünde, bir geliştiricinin yapmasına izin verilen çağrı sayısını şu seçenekleri belirleyerek de kontrol edebilirsiniz:

    Packages > PackageName > RatePlanName > Rate Card (Paketler > PaketAdı > ÜcretPlanıAdı > Ücret Kartı)

    Örneğin, paket adı Pro Paketi ise ve Ücretsiz Plan ise yol şöyle olur:

    Paketler > Pro Paketi > Ücretsiz Plan > Fiyat Listesi

NO_CURRENT_PUBLISHABLE_ENTITY

Geliştiricinin API çağrıları yapabilmesi için bir ücretli plan satın alması gerekir.

Para kazanma kurulumuyla ilgili sorunlar

Belirtiler

Para kazanma ayarlarıyla ilgili sorunlar, aşağıdakiler gibi farklı belirtilerle ortaya çıkabilir:

  • Web kancası işlevi çalışmıyor
  • Webhook oluşturulamıyor
  • Webhook bildirimleri tetiklenmiyor
  • Para kazanma raporlarında herhangi bir işlem gösterilmiyor. Örneğin, Analytics verileri, geliştiricinin belirli bir süre içinde birçok işlem tamamladığını gösteriyor ancak para kazanma raporlarında bu işlemlerin hiçbiri listelenmiyor.
  • İşlemler kaydedilmiyor

Hata mesajları

Herhangi bir hata mesajı görmeyebilirsiniz ancak Belirtiler bölümünde açıklandığı gibi sorunlar görürsünüz.

Olası nedenler

Belirtiler bölümünde listelenen belirtilerden herhangi birini görüyorsanız işlemlerden para kazanılmıyor olması çok olasıdır.

Nedeni teşhis etme

  1. İşlemlerden para kazanılıp kazanılmadığını kontrol etmek için aşağıdaki bölümde açıklanan yönetim API'si çağrısını kullanın.

    İşlemlerin durumunu görüntüleme

  2. Belirtilen süre içinde BAŞARILI olarak listelenen herhangi bir işlem görmüyorsanız işlemlerden para kazanılmamıştır.

İşlemlerden para kazanılmamasının yaygın nedenleri şunlardır:

Aşağıdaki bölümlerde her sorunun nasıl teşhis edileceği ve çözüleceği açıklanmaktadır.

API proxy'sinde para kazanmayla ilgili sınırlamaları kontrol etme politikası kullanılmıyor

Teşhis

  1. Para Kazandırma Sınırları Kontrolü Politikası'nın API proxy'lerine eklenip eklenmediğini kontrol edin.
  2. Politika eklenmemişse işlemlerin BAŞARISIZ olarak listelenmesinin nedeni bu olabilir.

Çözünürlük

API proxy'lerinde para kazanma sınırlarını zorunlu kılma bölümünde açıklandığı gibi, para kazanma sınırı kontrolü politikasını gerekli API proxy'lerine ekleyin.

Sorun devam ederse API ürünü para kazanma özelliğine sahip değil başlıklı makaleyi inceleyin.

API ürünü para kazanma özelliğine sahip değil

Teşhis

  1. API ürününün para kazandıran bir ürün olup olmadığını kontrol edin (yalnızca para kazandıran API ürünleri derecelendirilir ve işlemler altında listelenir). Para kazanılan ürün, en az bir etkin fiyat planı bulunan üründür.
  2. Para kazanılan API ürünlerinin listesini almak için aşağıdaki Management API çağrısını kullanın:
    1. Herkese açık bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. Özel bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. API proxy'nizle ilişkili API ürünü para kazanma özelliğine sahip değilse işlemlerden para kazanılmamasının nedeni bu olabilir.

Çözünürlük

Bir API ürününden para kazanmak için aşağıdaki adımları uygulayın:

  1. İşlem kaydı politikasını yapılandırın.

  2. API ürününün etkin bir fiyat planı olduğundan emin olun.

Sorun devam ederse işlem kayıt politikası yanlış tanımlanmış bölümünü inceleyin.

İşlem kayıt politikası yanlış tanımlanmış

Teşhis

  1. Para kazandırma sınırı kontrolü politikası eklenmiş API proxy'si için kullanıcı arayüzü izlemeyi etkinleştirin.
  2. Kullanıcı arayüzü izinden belirli bir API isteği seçin.
  3. Analytics AX akışını seçin ve aşağıdaki para kazanma (mint) akışı değişkenlerinin uygun değerlere sahip olup olmadığını kontrol edin:
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
    mint.tx.app_id - Application id of API product.
    mint.tx.prod_id - API product id.
  4. Aşağıda, mint akışı değişkenlerinin doğru şekilde ayarlandığını gösteren örnek bir kullanıcı arayüzü izi yer almaktadır.

  5. mint.tx.status değişkeninde bir hata görürseniz işlem kaydı politikasının yanlış tanımlandığı anlaşılır.

Çözünürlük

  1. İşlem kaydı politikası oluştururken İşlem kaydı politikası oluşturma başlıklı makalede belirtilen tüm adımların doğru şekilde uygulandığından emin olun.
  2. Anahtar değer, işlem kayıt politikasında belirlenen "işlem başarı ölçütleri"dir. İşlem kayıt politikasında işlem başarısı kriterlerini ayarlama örnekleri başlıklı makaleyi inceleyin.

Geliştirici ücret planı satın almadı

Teşhis

  1. Geliştirici tarafından satın alınan ücret planlarını doğrulamak için aşağıdaki Management API çağrısını kullanın:
    1. Herkese açık bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Özel bulut kullanıcısıysanız aşağıdaki API'yi kullanın:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. Yukarıdaki görüşmeden alınan yanıta göre, geliştirici tarafından işlemin tamamlandığı sırada etkin olan planı bulun.

Çözünürlük

Geliştirici, ihtiyaçlarına göre bir ücret planı satın almalı ve ardından işlemleri/API'leri yürütmelidir.

Sorun devam ederse Apigee Edge Destek Ekibi ile iletişime geçin.