<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보
선불 계정에서 잔액을 관리하는 방법은 다음과 같습니다.
- 현재 선불 계정의 잔액을 확인합니다. 자세한 내용은 선불 보기 계정 잔액을 확인할 수 있습니다.
- 서드 파티 결제 시스템 공급자를 통해 필요에 따라 계정 잔액을 다시 충전합니다.
(예: Worldpay) 타사를 통한 선불 잔액 관리
결제 시스템 공급자를 선택합니다.
또는 수동으로 또는 다음을 통해 결제를 추적하여 새로고침을 관리할 수 있습니다. 수익 창출 API를 호출하여 계정을 다시 로드할 수 있습니다. 수동으로 선불 잔액 관리에 설명되어 있습니다.
- 선불 계정 잔액이 특정 기준액 아래로 떨어지면 자동 충전을 설정합니다. 수익 창출 API 및 Worldpay와 같은 제3자 결제 시스템 공급자를 통해 이루어집니다. 이 옵션은 요금제의 정기 결제를 관리하는 데 유용합니다. 자세한 내용은 설정 API를 사용한 선불 계정 잔액 자동 충전.
선불 계정의 잔액은 어떻게 계산하나요?
다음 섹션에 설명된 대로 개발자나 회사의 선불 계정 잔액을 확인할 때 다음을 수행해야 합니다. 응답에서 다음 값을 가져옵니다.
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
응답은 위에 표시된 응답과 유사합니다. 개발자에게 맡기세요