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 sunar.

Ön ödemeli geliştiriciler için kredi, kullanımda azalma olarak görünür. Bu durum, geliştiricinin ön ödemeli bakiyesini artırır veya azaltır. Banka kartı kullanımına benzer şekilde, geliştirici bir API ürün paketi satın aldığında ön ödemeli bakiyesinden para çekilir. Geliştirici, satın alma işlemleri için yeterli bakiyeye sahip olmalıdır. Kalan ön ödemeli hesap bakiyesini nasıl hesaplarım? başlıklı makaleyi inceleyin.

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

Credits 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 uygulandığı faturalandırma ayı. Listeden bir ay seçin.
   Geliştirici	Kredinin uygulandığı geliştirici veya şirket adı. Metin kutusuna adı girin. Yazmaya başladığınızda, dizeyi içeren geliştiricilerin/şirketlerin listesi açılır listede 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. Bir ücret planını kabul etmemiş bir şirket veya geliştiriciyi seçerseniz kredi veremezsiniz.
   Ürün paketi	Kredinin uygulandığı API ürün paketi. Kullanılabilir API ürün paketleri listesinden seçim yapın.
   Ürün	Kredinin uygulandığı, seçilen API ürün paketindeki API ürünü. Tüm Ürünler'i veya listeden 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 fiyat planında birden fazla para birimi tanımlanmışsa bu 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 geliştiriciye, bir API ürün paketinin tamamı veya bir API ürün paketindeki belirli bir API ürününün kullanımı için 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. Burada {package_id} ve {rate-plan_id}, sırasıyla kredinin uygulandığı API ürün paketi ve ücret planının tanımlanmasını ifade eder.

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

• Kredinin uygulandığı geliştiricinin kimliği (e-posta adresi).
• Kredinin 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 uygulandığı 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 geçerli yıl olarak ayarlanır.
• Kredinin uygulandığı 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ı tutarında bir 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 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ıttan bir örnek 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, krediler API'si ile kullanılabilir: