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 kazanma özelliğinin ilk kurulumu kapsamında kuruluşunuz tarafından desteklenen para birimlerini ve 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 silebilirsiniz (para birimleri bir geliştirici ya da fiyat planı tarafından kullanılmıyorsa).

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

Desteklenen para birimlerini yönetin ve Kuruluş Profili sayfasının Vergi ve Para Birimi bölümünde 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ş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 tek 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ı. 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 (kullanılıp kullanılamadığı).
• Desteklenen para biriminin ekleneceği kuruluş.

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

• Desteklenen bir para birimi için kredi limiti (yalnızca faturalı ödeme yapan geliştiriciler).
• Desteklenen bir para birimi için minimum yükleme tutarı (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 kod bir kuruluş için desteklenen bir para birimi ekler:

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 kodu olarak ayarlayarak kuruluşun varsayılan para birimini belirleyin. Bu işlem, API'yi kullanarak kuruluş profilini yönetme başlıklı makalede açıklanmıştır.

API'yi kullanarak desteklenen bir para birimini düzenleme

/mint/organizations/{org_name}/{supportedCurrencyId} adresine bir PUT isteği göndererek desteklenen bir para birimini düzenleyin. Burada {supportedCurrency_id}, güncellenecek desteklenen para biriminin kimliğidir. İstek gövdesinde, güncellenen özellikleri ve desteklenen para birimi kimliğini 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 (örnekte güncellenen özellikler 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} adresine bir DELETE isteği göndererek desteklenen bir para birimini silin. Burada {currency_id}, silinecek desteklenen para biriminin tanımlayıcısı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 ayarlanabilen yapılandırma özellikleri özetlenmektedir.