Kredi verenler

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

Giriş

Para kazanma özelliği, geliştirici kredisi vermeniz için esneklik sağlar.

Ön ödemeli geliştirici için kredi kullanımında bir azalma olarak görünür. Bu, geliştiricinin ön ödeme bakiyesini artırır veya azaltır. Benzer Geliştiricinin ön ödemeli bakiyesinden para çekilirse geliştiricinin ön ödeme bakiyesi Geliştirici bir API ürün paketi satın alır. Geliştiricinin abonelik için yeterli bakiyeyi değeri için teklif verirsiniz. Kalan ön ödemeli hesap bakiyesini nasıl hesaplarım? bölümüne göz atın.

Faturalı ödeme yapan bir geliştirici için kredi, Böylece, faturadaki masrafı azaltarak faturada ayrı bir satıra girebilirsiniz.

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 etmemiş 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	Seçilen API ürün paketindeki, kredinin geçerli olduğu API ürünü. Seç Tüm Ürünler veya listeden tek bir API ürünü.
   Para Birimi	Kredi için kullanılan para birimi. Para birimi, şu özelliklere sahip API ürün paketindeki ücret planı için yapılandırılmıştır: Satın alınan geliştiricidir ve değiştirilemez. Bir ücret planında tanımlanmış birden fazla para birimi varsa 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 tamamı için geliştiriciye kredi gönderme veya bir API ürün paketinde belirli bir API ürününün kullanımına karşı.

API'yi kullanarak kredi yayınlamak için şu adrese bir POST isteği gönderin: /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions, burada {package_id} ve {rate-plan_id}, Kredinin geçerli olduğu API ürün paketinin ve ücret planının tanımlanması.

İsteği gönderirken 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 şu aya ayarlanır: ay.
• 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ü belirtmezseniz kredi, API ürün paketindeki tüm API ürünleri için geçerlidir.

Örneğin, aşağıdaki istek Nisan 2018'deki faturalandırma ayı için 100 TL'lik kredi verir dev1@myorg.com olarak tanımlanan bir geliştiriciye gönderilir. Kredinin geçerliliği: payment API ürün paketi ve payment_standard_plan ücret planı:

Sorgu parametrelerinin tam listesi için Krediler API'si için sorgu parametreleri bölümüne bakın kredi isteğinde belirtebileceğiniz gibi.

$ 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 örnek bir alıntı 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: