Kredi verenler

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

Giriş

Para kazanma özelliği, geliştirici kredisi verme esnekliği sağlar.

Ön ödemeli geliştirici için kredi, kullanımın azalması olarak görünür. Bu, geliştiricinin ileriye dönük ön ödeme bakiyesini artırır veya azaltır. Geliştirici bir API ürün paketi satın aldığında, banka kartı kullanımına benzer şekilde, geliştiricinin ön ödeme bakiyesinden para çekilir. Geliştirici, satın alma işlemleri için yeterli bakiyeyi sağlamalıdır. Kalan ön ödemeli hesap bakiyesini nasıl hesaplarım? bölümüne göz atın.

Faturalı ödeme geliştirici için kredi, faturada ayrı bir satır olarak görünür ve faturadaki ücreti azaltır.

Krediler sayfasını keşfetme

Aşağıda açıklandığı şekilde Krediler sayfasına erişin ve sayfayı inceleyin.

Kredi verme

1. Krediler 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 geçerli olduğu geliştirici veya şirketin adı. Adı metin kutusuna girin. Siz yazarken, dizeyi içeren geliştiricilerin/şirketlerin listesi bir açılır listede görüntülenir. 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. Mevcut 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ü. Tüm Ürünler'i veya listeden tek bir API ürününü seçin.
   Currency	Kredi için kullanılan para birimi. Para birimi, geliştiricinin satın aldığı API ürün paketindeki ücret planına göre yapılandırılmıştır ve değiştirilemez. Ücret planında birden fazla para birimi tanımlanmışsa para birimlerinden birini seçebilirsiniz.
   Tutar	Kredinin 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 paketinin bütünü için veya bir API ürün paketinde belirli bir API ürününün kullanımına karşılık olarak geliştiriciye kredi verin.

API'yi kullanarak kredi yayınlamak 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. Burada {package_id} ve {rate-plan_id}, sırasıyla kredinin geçerli olduğu API ürün paketinin ve ücret planının tanımını tanımlar.

İsteği gönderdiğinizde, sorgu parametreleri olarak 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.

İsteğe bağlı olarak, aşağıdaki ek sorgu parametrelerini belirtebilirsiniz:

• Kredinin geçerli olduğu faturalandırma ayı. Bu değer varsayılan olarak geçerli aya ayarlanır.
• Kredinin geçerli olduğu faturalandırma yılı. Bu değer varsayılan olarak mevcut yıla ayarlanır.
• Kredinin geçerli olduğu API ürünü. Bir 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'in faturalandırma ayı için 100 ABD doları tutarında 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 Krediler API'si için sorgu parametreleri bölümüne bakın.

$ 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ıttan alıntılanan bir örnek yer almaktadır:

{
  "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ına göre yapılandırılmıştı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çıklayın.	Yok	Evet