크레딧 발급

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

소개

수익 창출을 통해 개발자 크레딧을 유연하게 발급할 수 있습니다.

선불 개발자의 경우 크레딧은 사용량이 감소한 것으로 보입니다. 이에 따라 개발자의 선불 잔액이 앞으로 늘어나거나 줄어듭니다. 매우 유사함 개발자의 선불 잔액에서 금액이 인출되면 개발자가 API 제품 번들을 구매할 때 개발자는 수익 창출 기회를 위해 적절한 균형을 유지해야 합니다. 구매. 선불 계정의 잔여 잔액은 어떻게 계산하나요?를 참고하세요.

후불 개발자의 경우 크레딧은 다음과 같이 표시됩니다. 인보이스에 별도의 행을 추가하면 인보이스의 청구액을 줄일 수 있습니다.

크레딧 페이지 살펴보기

아래에 설명된 대로 크레딧 페이지에 액세스하고 살펴봅니다.

크레딧 발급

1. 크레딧 페이지에 액세스합니다.
2. + 크레딧을 클릭합니다.
3. 다음 정보를 입력합니다.

   필드	설명
   결제 월	크레딧이 적용되는 결제 월입니다. 목록에서 월을 선택합니다.
   개발자	크레딧이 적용되는 개발자 또는 회사 이름 텍스트 상자에 이름을 입력합니다. 입력할 때 문자열이 포함된 개발자/회사 목록이 드롭다운으로 표시됩니다. 드롭다운 목록에서 개발자 또는 회사의 이름을 클릭합니다. 참고: 개발자나 회사를 선택하면 나머지 필드가 표시됩니다. 요금제를 수락하지 않은 회사 또는 개발자를 선택하면 크레딧을 발급할 수 없습니다.
   제품 번들	크레딧이 적용되는 API 제품 번들입니다. 사용 가능한 API 제품 번들 목록에서 선택하세요.
   제품	크레딧이 적용되는 선택한 API 제품 번들의 API 제품입니다. 선택 모든 제품 또는 목록에서 단일 API 제품을 선택합니다.
   통화	크레딧에 사용된 통화입니다. 통화는 개발자가 구매했으며 변경할 수 없습니다. 요금제에 여러 통화가 정의되어 있는 경우 통화 중 하나를 선택할 수 있습니다.
   금액	크레딧 금액 (지정된 통화 기준) 양수 또는 음수 값을 지정합니다. 이 값은 0일 수 없습니다.
   참고	크레딧 사유를 설명하는 메모입니다(선택사항).

4. 크레딧 저장을 클릭합니다.

API를 사용한 크레딧 발급

API를 사용하여 API 제품 번들 전체에 대해 개발자에게 크레딧을 발행합니다. API 제품 번들의 특정 API 제품 사용에 대한 제한

API를 사용하여 크레딧을 발행하려면 POST 요청을 발행하세요. /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions, 여기서 {package_id}와 {rate-plan_id}는 크레딧이 적용되는 API 제품 번들 및 요금제 식별

요청을 실행할 때 다음을 쿼리 매개변수로 지정해야 합니다.

• 크레딧이 적용되는 개발자 ID (이메일 주소)
• 크레딧 금액입니다.
• 크레딧에 사용된 통화입니다.
• 크레딧 제공 이유를 설명하는 메모

원하는 경우 다음과 같은 추가 쿼리 매개변수를 지정할 수 있습니다.

• 크레딧이 적용되는 결제 월입니다. 이 값은 현재 월
• 크레딧이 적용되는 결제 연도입니다. 이 값의 기본값은 현재 연도입니다.
• 크레딧이 적용되는 API 제품입니다. API 제품을 지정하지 않는 경우 크레딧은 API 제품 번들의 모든 API 제품에 적용됩니다.

예를 들어 다음 요청은 2018년 4월 결제 월에 100달러의 크레딧을 지급합니다. 개발자(dev1@myorg.com)로 식별됩니다. 크레딧은 API 제품 번들 payment개 및 payment_standard_plan 요금제:

전체 쿼리 매개변수 목록은 크레딧 API의 쿼리 매개변수를 참고하세요. 신용 요청에서 지정할 수 있습니다

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

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

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

크레딧 API의 쿼리 매개변수

다음 쿼리 매개변수를 크레딧 API와 함께 사용할 수 있습니다.