지원되는 통화 관리

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

소개

수익 창출의 초기 설정의 일부로 Apigee Edge 구성팀은 통화 및 조직에서 지원하는 기본 통화를 구성합니다.

조직에서 지원하는 통화를 보거나, 지원되는 통화를 추가하거나, 지원되는 통화를 삭제할 수 있습니다 (통화가 개발자 또는 요금제에서 사용되지 않는 경우).

UI를 사용하여 지원되는 통화 관리

조직 프로필 페이지의 세금 및 통화 섹션에서 지원되는 통화를 관리하고 기본 통화를 설정합니다. 자세한 내용은 UI를 사용하여 조직 프로필 관리를 참조하세요.

API를 사용하여 지원되는 통화 관리

다음 섹션에 설명된 대로 API를 사용하여 지원되는 통화를 관리합니다.

API를 사용하여 지원되는 통화 보기

조직에서 지원하는 개별 통화 또는 조직에서 지원하는 모든 통화 조직에서 지원합니다.

조직에서 지원하는 개별 통화를 보려면 /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId}에 GET 요청을 실행합니다. 여기서 {supportedCurrency_id}는 볼 지원되는 통화의 식별자입니다. 예를 들면 다음과 같습니다.

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

조직에서 지원하는 모든 통화를 보려면 /mint/organizations/{org_name}/supported-currencies에 GET 요청을 실행합니다. 예를 들면 다음과 같습니다.

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

다음은 응답의 예시입니다.

{
"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를 사용하여 지원되는 통화 추가

/mint//organizations/{org_name}/supported-currencies에 POST 요청을 실행하여 지원되는 통화를 추가합니다. 추가하는 각 지원되는 통화에 대해, 요청 본문에 다음 정보를 지정해야 합니다.

  • 지원되는 통화의 이름입니다. 이름은 통화의 ISO 4217 코드입니다(예: 미국 달러의 경우 USD).
  • 표시 이름
  • 설명
  • 통화가 가상 화폐인지 여부입니다.
  • 통화의 상태, 즉 통화를 사용할 수 있는지 여부입니다.
  • 지원되는 통화가 추가될 조직입니다.

선택적으로 다음을 설정할 수 있습니다.

  • 지원되는 통화의 신용 한도 (후불 개발자만 해당)
  • 지원되는 통화의 최소 충전 금액 (선불 개발자만 해당)

자세한 내용은 지원되는 통화 구성 속성을 참조하세요.

예를 들어 다음은 조직의 지원되는 통화를 추가합니다.

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를 사용하여 기본 통화 설정

currency 값을 지원되는 ISO 4217 통화 코드로 설정하여 조직의 기본 통화를 설정합니다. 조직 프로필을 수정할 때 API를 사용하여 조직 프로필 관리에 설명된 대로

API를 사용하여 지원되는 통화 수정

/mint/organizations/{org_name}/{supportedCurrencyId}에 PUT 요청을 실행하여 지원되는 통화를 수정합니다. 여기서 {supportedCurrency_id}는 업데이트할 지원되는 통화의 식별자입니다. 요청 본문에 업데이트된 속성 과 지원되는 통화 ID를 지정해야 합니다. 예를 들어 다음 API 호출은 지원되는 통화의 설명과 표시 이름을 수정합니다 (업데이트된 속성은 예시에서 강조표시됨).

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를 사용하여 지원되는 통화 삭제

/mint/organizations/{org_name}/supported-currencies/{currency_id}에 DELETE 요청을 실행하여 지원되는 통화를 삭제합니다. 여기서 {currency_id}는 삭제할 지원되는 통화의 식별자입니다. 예를 들면 다음과 같습니다.

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

API의 통화 구성 속성

다음 표에는 API를 사용하여 설정할 수 있는 구성 속성이 요약되어 있습니다.

이름 설명 기본값 필수 여부
creditLimit

이 속성은 후불 개발자에게만 적용됩니다. 지원되는 통화의 신용 한도입니다.

 해당 사항 없음 아니요
description

지원되는 통화에 대한 설명입니다.

 해당 사항 없음 예
displayName

지원되는 통화의 표시 이름입니다.

 해당 사항 없음 예
minimumTopupAmount

이 속성은 선불 개발자에게만 적용됩니다. 개발자가 지정된 통화로 선불 계정 잔액에 추가할 수 있는 최소 금액입니다.

 해당 사항 없음 아니요
name

통화의 ISO 4217 코드입니다(예: 미국 달러의 경우 USD).

 해당 사항 없음 예
organization

지원되는 통화의 조직입니다.

 해당 사항 없음 예
status

지원되는 통화의 상태입니다. 유효한 값으로 다음이 포함되어 있습니다.

  • ACTIVE: 지원되는 통화를 사용할 수 있습니다.
  • INACTIVE: 지원되는 통화를 사용할 수 없습니다.
 해당 사항 없음 예
virtualCurrency

지원되는 통화가 가상 화폐인지 여부를 나타냅니다. 유효한 값으로 다음이 포함되어 있습니다.

  • true: 지원되는 통화는 가상 화폐입니다.
  • false: 지원되는 통화는 가상 화폐가 아닙니다.
 해당 사항 없음 예