Desteklenen para birimlerini yönetme

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

Giriş

Apigee Edge yapılandırma ekibi, para kazanmayla ilgili ilk kurulumunun bir parçası olarak para birimlerini ve kuruluşunuz tarafından desteklenen varsayılan para birimini yapılandırır.

Kuruluşunuzun desteklediği para birimlerini görüntüleyebilir, desteklenen para birimlerini ekleyebilir veya desteklenen para birimlerini (para birimleri bir geliştirici veya ücret planı tarafından kullanılmıyorsa) silebilirsiniz.

Kullanıcı arayüzünü kullanarak desteklenen para birimlerini yönetme

Kuruluş Profili sayfasının Vergi ve Para Birimi bölümünde, desteklenen para birimlerini yönetin ve varsayılan para birimini ayarlayın. Ayrıntılar için Kullanıcı arayüzünü kullanarak kuruluş profilini yönetme başlıklı makaleyi inceleyin.

API'yi kullanarak desteklenen para birimlerini yönetme

Aşağıdaki bölümlerde açıklandığı gibi, API'yi kullanarak desteklenen para birimlerini yönetin.

API'yi kullanarak desteklenen para birimlerini görüntüleme

Kuruluşunuzun desteklediği bir para birimini veya kuruluşunuzun desteklediği tüm para birimlerini görüntüleyin.

Kuruluşunuzun desteklediği bir para birimini görüntülemek için /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId} adresine bir GET isteği gönderin. Burada {supportedCurrency_id}, görüntülenecek desteklenen para biriminin kimliğidir. Örneğin:

curl -X GET -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password

Kuruluşunuzun desteklediği tüm para birimlerini görüntülemek için /mint/organizations/{org_name}/supported-currencies adresine bir GET isteği gönderin. Örneğin:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -H "Accept: application/json"  \
-u email:password

Aşağıda yanıta dair bir örnek verilmiştir:

{
"supportedCurrency" : [ {
    "description" : "US Dollar",
    "displayName" : "US Dollar",
    "id" : "usd",
    "name" : "USD",
    "organization" : {
      ...
    "status" : "ACTIVE",
    "virtualCurrency" : false
  }, {
    "creditLimit" : 5000.0000,
    "description" : "Euro",
    "displayName" : "Euro",
    "id" : "eur",
    "name" : "EUR",
    "organization" : {
      ...
    },
    "status" : "INACTIVE",
    "virtualCurrency" : false  
  } ],
  "totalRecords" : 2
}

API'yi kullanarak desteklenen para birimlerini ekleme

/mint//organizations/{org_name}/supported-currencies adresine bir POST isteği göndererek desteklenen para birimlerini ekleyin. Eklediğiniz her desteklenen para birimi için istek gövdesinde aşağıdaki bilgileri belirtmeniz gerekir:

  • Desteklenen para biriminin adı. Bu ad, para biriminin ISO 4217 kodudur (ör. ABD doları için USD).
  • Görünen ad.
  • Açıklama.
  • Para biriminin sanal para birimi olup olmadığı.
  • Para biriminin durumu (ör. kullanılabilir olup olmadığı).
  • Desteklenen para biriminin ekleneceği kuruluş.

İsteğe bağlı olarak şunları ayarlayabilirsiniz:

  • Desteklenen bir para birimi için kredi limiti (yalnızca sonradan ödemeli geliştiriciler).
  • Desteklenen bir para birimi için minimum para ekleme (yalnızca ön ödemeli geliştiriciler).

Daha fazla bilgi için Desteklenen para birimi yapılandırma özellikleri başlıklı makaleyi inceleyin.

Örneğin, aşağıdaki kodda bir kuruluş için desteklenen bir para birimi eklenmektedir:

curl -H "Content-Type: application/json" -X POST -d \
  '{
     "description": "US Dollar",
     "displayName": "US Dollar",
     "virtualCurrency": "false",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status": "ACTIVE"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -u email:password

API'yi kullanarak varsayılan para birimini ayarlama

API'yi kullanarak kuruluş profilini yönetme başlıklı makalede açıklandığı gibi, kuruluş profilini düzenlerken currency değerini desteklenen bir ISO 4217 para birimi koduna ayarlayarak kuruluşun varsayılan para birimini belirleyin.

API'yi kullanarak desteklenen bir para birimini düzenleme

/mint/organizations/{org_name}/{supportedCurrencyId} öğesine bir PUT isteği göndererek desteklenen bir para birimini düzenleyin. Burada {supportedCurrency_id}, güncellenecek desteklenen para biriminin tanımıdır. İstekte, güncellenen özelliklerin yanı sıra desteklenen para birimi kimliğini de belirtmeniz gerekir. Örneğin, aşağıdaki API çağrısı, desteklenen bir para biriminin açıklamasını ve görünen adını düzenler (güncellenen özellikler örnekte vurgulanmıştır):

curl -H "Content-Type: application/json" -X PUT -d \
  '{
     "description": "United States Dollar",
     "displayName": "United States Dollar",
     "id": "usd",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status" : "ACTIVE",
     "virtualCurrency": "false"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organization/{org_name}/supported-currencies/usd" -d \
  -u email:password

Desteklenen bir para birimini API'yi kullanarak silme

/mint/organizations/{org_name}/supported-currencies/{currency_id} adresine DELETE isteği göndererek desteklenen bir para birimini silin. Bu durumda, {currency_id}, silinecek desteklenen para biriminin kimliğidir. Örneğin:

curl -X DELETE -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
  -u email:password

API için para birimi yapılandırma özellikleri

Aşağıdaki tabloda, API kullanılarak ayarlanabilecek yapılandırma özellikleri özetlenmiştir.

Ad Açıklama Varsayılan Zorunlu mu?
creditLimit

Bu özellik yalnızca sonradan ödemeli geliştiriciler için geçerlidir. Desteklenen para birimi için kredi sınırı.

Yok Hayır
açıklama

Desteklenen para biriminin açıklaması.

Yok Evet
görünen ad

Desteklenen para birimi için görüntülenecek ad.

Yok Evet
minimumTopupAmount

Bu özellik yalnızca ön ödemeli geliştiriciler için geçerlidir. Geliştiricilerin, belirtilen para biriminde ön ödemeli hesap bakiyelerine ekleyebileceği minimum tutar.

Yok Hayır
ad

Para biriminin ISO 4217 kodu (ör. ABD doları için USD).

Yok Evet
kuruluş

Desteklenen para biriminin kuruluşu.

Yok Evet
durum

Desteklenen para biriminin durumu. Geçerli değerler şunlardır:

  • ETKİN: Desteklenen para birimi kullanılabilir.
  • ETKİN DEĞİL: Desteklenen para birimi kullanılamıyor.
Yok Evet
virtualCurrency

Desteklenen para biriminin sanal para birimi olup olmadığını belirtir. Geçerli değerler şunlardır:

  • true: Desteklenen para birimi sanal para birimidir.
  • false: Desteklenen para birimi sanal para birimi değildir.
Yok Evet