Desteklenen para birimlerini yönetme

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

Giriş

Apigee Edge yapılandırma ekibi, para kazanmayla ilgili ilk kurulum kapsamında kuruluşunuzun desteklediği para birimlerini ve varsayılan para birimini yapılandırır.

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

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 bölümüne bakın.

API'yi kullanarak desteklenen para birimlerini yönetme

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

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

Kuruluşunuz tarafından desteklenen tek bir para birimini veya kuruluşunuz tarafından desteklenen tüm para birimlerini görüntüleyin.

Kuruluşunuz tarafından desteklenen bağımsız 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 tanımlamasıdır. Ö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şunuz tarafından desteklenen tüm para birimlerini görüntülemek için /mint/organizations/{org_name}/supported-currencies adresine 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ıtla ilgili bir örnek yer almaktadır:

{
"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 öğesine 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ı. 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, yani para biriminin 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 ödeme yapan 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 bölümüne bakın.

Örneğin, aşağıda bir kuruluş için desteklenen bir para birimi eklenir:

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

Kuruluş profilini düzenlerken currency değerini desteklenen bir ISO 4217 para birimi koduna ayarlayarak kuruluşun varsayılan para birimini ayarlayın (API'yi kullanarak kuruluş profilini yönetme bölümünde açıklandığı şekilde).

API'yi kullanarak desteklenen bir para birimini düzenleme

/mint/organizations/{org_name}/{supportedCurrencyId} için PUT isteği göndererek desteklenen bir para birimini düzenleyin. Burada {supportedCurrency_id}, güncellenecek para birimini temsil eder. İstek gövdesinde, güncellenen özelliklerin yanı sıra desteklenen para birimi kimliğini belirtmeniz gerekir. Örneğin, aşağıdaki API çağrısı, desteklenen bir para birimi için açıklamayı ve görünen adı düzenler (güncellenmiş ö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

API'yi kullanarak desteklenen bir para birimini silme

/mint/organizations/{org_name}/supported-currencies/{currency_id} için DELETE isteği göndererek desteklenen bir para birimini silin. Burada {currency_id}, silinecek desteklenen para biriminin tanımlamasıdır. Ö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 özetlenmektedir.

Ad	Açıklama	Varsayılan	Zorunlu mu?
creditLimit	Bu özellik yalnızca faturalı geliştiriciler için geçerlidir. Desteklenen para birimi için kredi limiti.	Yok	Hayır
açıklama	Desteklenen para biriminin açıklaması.	Yok	Evet
displayName	Desteklenen para birimi için gösterilecek ad.	Yok	Evet
minimumTopupAmount	Bu özellik yalnızca ön ödemeli geliştiriciler için geçerlidir. Geliştiricilerin, belirtilen para birimi cinsinden ön ödemeli hesap bakiyelerine ekleyebileceği minimum tutardır.	Yok	Hayır
ad	Para birimi için 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 şunları içerir: 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 şunları içerir: true: Desteklenen para birimi, sanal para birimidir. false: Desteklenen para birimi, sanal para birimi değildir.	Yok	Evet