Kredi verenler

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

Giriş

Para kazanma, geliştirici kredisi verme esnekliği sunar.

Ön ödemeli geliştirici için kredi, kullanımdaki azalma olarak görünür. Bu da geliştiricinin ön ödeme bakiyesini artırır veya azaltır. Banka kartı kullanmaya benzer şekilde, geliştirici bir API ürün paketi satın aldığında geliştiricinin ön ödemeli bakiyesinden para çekilir. Geliştirici, satın alma işlemleri için yeterli bakiye bulundurmalıdır. Ön ödemeli hesaptaki kalan bakiyeyi nasıl hesaplarım? başlıklı makaleyi inceleyin.

Sonradan ödemeli geliştirici için kredi, faturada ayrı bir satır olarak görünerek faturadaki ücretin azalmasını sağlar.

Krediler sayfasını keşfetme

Aşağıda açıklandığı şekilde Krediler sayfasına erişip sayfayı keşfedin.

Kredi verme

1. Kredi sayfasına erişin.
2. + Kredi'yi tıklayın.
3. Aşağıdaki bilgileri girin:

   Alan	Açıklama
   Faturalandırma Ayı	Kredinin geçerli olduğu faturalandırma ayı. Listeden bir ay seçin.
   Geliştirici	Kredinin uygulandığı geliştirici veya şirket adı. Adı metin kutusuna girin. Siz yazdıkça, açılır listede dize içeren geliştiricilerin/şirketlerin listesi gösterilir. Açılır listeden geliştiricinin veya şirketin adını tıklayın. Not: Bir geliştirici veya şirket seçtikten sonra kalan alanlar gösterilir. Ücret planını kabul etmeyen bir şirket veya geliştirici seçerseniz kredi veremezsiniz.
   Ürün Paketi	Kredinin geçerli olduğu API ürün paketi. Kullanılabilir API ürün paketleri listesinden seçim yapın.
   Ürün	Kredinin geçerli olduğu, seçili API ürün paketindeki API ürünü. Listeden Tüm Ürünler'i veya tek bir API ürününü seçin.
   Para Birimi	Kredi için kullanılan para birimi. Para birimi, geliştiricinin satın aldığı API ürün paketindeki ücret planı için yapılandırılır ve değiştirilemez. Bir ücret planında birden fazla para birimi tanımlanmışsa para birimlerinden birini seçebilirsiniz.
   Tutar	Kredi tutarı (belirtilen para biriminde). Pozitif veya negatif bir değer belirtin. Değer sıfır olamaz.
   Not	Kredinin nedenini açıklayan isteğe bağlı not.

4. Krediyi Kaydet'i tıklayın.

API'yi kullanarak kredi verme

API'yi kullanarak, bir API ürün paketi için geliştiriciye kredi verin veya API ürün paketindeki belirli bir API ürünü için geliştiriciye kredi verin.

API'yi kullanarak kredi vermek için /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions adresine bir POST isteği gönderin. Bu istekte {package_id} ve {rate-plan_id}, sırasıyla kredinin geçerli olduğu API ürün paketinin ve ücret planının kimliğini tanımlar.

İsteği gönderirken sorgu parametreleri olarak şunları belirtmeniz gerekir:

• Kredinin geçerli olduğu geliştirici kimliği (e-posta adresi).
• Kredi tutarı.
• Kredi için kullanılan para birimi.
• Kredinin nedenini açıklayan not.

Dilerseniz aşağıdaki ek sorgu parametrelerini belirtebilirsiniz:

• Kredinin geçerli olduğu faturalandırma ayı. Bu değer varsayılan olarak geçerli aydır.
• Kredinin geçerli olduğu faturalandırma yılı. Bu değer varsayılan olarak geçerli yıl olarak ayarlanır.
• Kredinin geçerli olduğu API ürünü. API ürün kimliği belirtmezseniz kredi, API ürün paketindeki tüm API ürünleri için geçerli olur.

Örneğin, aşağıdaki istek, dev1@myorg.com olarak tanımlanan bir geliştiriciye Nisan 2018 faturalandırma ayı için 100 ABD doları kredi verir. Kredi, payment API ürün paketi ve payment_standard_plan ücret planı için geçerlidir:

Kredi isteğinde belirtebileceğiniz sorgu parametrelerinin tam listesi için Credits API için sorgu parametreleri başlıklı makaleyi inceleyin.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

Aşağıda, yanıtın örnek bir alıntısı verilmiştir:

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

Krediler API'si için sorgu parametreleri

Aşağıdaki sorgu parametreleri, Credit API ile kullanılabilir:

Ad	Açıklama	Varsayılan	Zorunlu mu?
billingMonth	Kredinin geçerli olduğu faturalandırma ayı (ör. NİSAN).	Yok	Hayır
billingYear	Kredinin geçerli olduğu faturalandırma yılı (ör. 2018).	Yok	Hayır
currencyId	Kredi için kullanılan para birimi. Para birimi, geliştiricinin satın aldığı API ürün paketindeki ücret planı için yapılandırılır ve değiştirilemez.	Yok	Evet
developerId	Kredinin geçerli olduğu geliştirici veya şirketin adı.	Yok	Evet
productId	Kredinin geçerli olduğu API ürünü. Ürün kimliği belirtmezseniz kredi, API ürün paketindeki tüm API ürünleri için geçerli olur.	Yok	Hayır
transactionAmount	Kredinin tutarı (belirtilen para biriminde). Pozitif veya negatif bir değer belirtin. Değer sıfır olamaz.	Yok	Evet
transactionNote	Kredinin nedenini açıklayan not.	Yok	Evet