선불 계정 잔액 관리

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

선불 계정에서 잔액을 관리하는 방법은 다음과 같습니다.

선불 계정의 잔액은 어떻게 계산하나요?

다음 섹션에 설명된 대로 개발자나 회사의 선불 계정 잔액을 확인할 때 다음을 수행해야 합니다. 응답에서 다음 값을 가져옵니다.

  • amount: 현재 결제 기간에 사용할 수 있는 총 금액입니다. 새로고침하면 이 값이 업데이트됩니다. 선불 계정에 결제해야 합니다.
  • usage: 현재 결제 기간 동안 사용된 총 금액입니다. 이 값은 요건을 충족하는 각 수익 창출로 업데이트됩니다. 크레딧 발행 (긍정적 또는 부정적)으로 간주됩니다.

공식의 현재 결제 기간에 대한 선불 계정의 남은 잔액usage amount 값입니다. 예를 들어 amount 값이 335.50이고 usage 값이 34인 경우 잔액은 다음과 같이 계산됩니다.

amount(335.50) - usage(34) = 229.50
드림

API를 사용하여 선불 계정 잔액 보기

다음 섹션에서는 개발자의 선불 계정 잔액을 확인하는 방법 또는 개발자의 선불 계정 잔액을 확인하는 방법을 설명합니다. API를 사용하고 있습니다.

개발자의 선불 계정 잔액 보기

개발자의 선불 계정 잔액을 보려면 다음 API 중 하나에 GET 요청을 실행합니다. 여기서 {developer_id}는 개발자의 이메일 주소입니다.

  • /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: 개발자의 선불 계정 잔액과 반복 설정 정보를 반환합니다.
  • /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: 다음과 같은 선불 계정 잔액 정보를 반환합니다. 현재 및 총 잔액, 사용량, 충전, 사용세

다음 쿼리 매개변수를 전달하여 결과를 필터링할 수 있습니다.

쿼리 매개변수 설명
all 모든 API 패키지를 반환할지 여부를 지정하는 플래그입니다. false로 설정하면 페이지당 반환되는 API 패키지 수는 다음과 같습니다. size 쿼리 매개변수로 정의됩니다. 기본값은 false입니다.
size 페이지당 반환된 API 패키지 수입니다. 기본값은 20입니다. all 쿼리가 매개변수가 true로 설정되면 이 매개변수는 무시됩니다.
page 반환할 페이지의 번호입니다 (콘텐츠에 페이지가 매겨진 경우). 만약 all 쿼리 매개변수가 true로 설정되어 있으면 매개변수는 무시됩니다.
currencyId 선불 계정 잔액을 확인할 통화의 ID입니다.

예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

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

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

회사의 선불 계정 잔액 보기

회사의 선불 계정 잔액을 보려면 GET 요청을 발행하세요. /mint/organizations/{org_name}/companies/{company_id}/developer-balances, 각 항목의 의미는 다음과 같습니다. {company_id}는 회사 ID입니다. 회사가 선불인 경우 요청 현재 선불 계정 잔액을 검색합니다. 회사가 후불인 경우 요청은 현재 신용 한도.

다음 쿼리 매개변수를 전달하여 결과를 필터링할 수 있습니다.

쿼리 매개변수 설명
all 모든 API 패키지를 반환할지 여부를 지정하는 플래그입니다. false로 설정하면 페이지당 반환되는 API 패키지 수는 다음과 같습니다. size 쿼리 매개변수로 정의됩니다. 기본값은 false입니다.
size 페이지당 반환된 API 패키지 수입니다. 기본값은 20입니다. all 쿼리가 매개변수가 true로 설정되면 이 매개변수는 무시됩니다.
page 반환할 페이지의 번호입니다 (콘텐츠에 페이지가 매겨진 경우). 만약 all 쿼리 매개변수가 true로 설정되어 있으면 매개변수는 무시됩니다.
currencyId 선불 계정 잔액을 확인할 통화의 ID입니다.

예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

응답은 위에 표시된 응답과 유사합니다. 개발자에게 맡기세요