이 페이지는 Cloud Translation API를 통해 번역되었습니다.

결제 조정하기

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

소개

수익 창출을 통해 결제 세부정보를 조정할 수 있습니다. 예를 들어 특정 결제 월의 수익 지분 또는 수수료를 늘리거나 줄이려고 기록상의 불일치가 있을 수 있습니다.

결제 조정 페이지 살펴보기

아래 설명에 따라 결제 조정 페이지에 액세스합니다.

에지

Edge UI를 사용하여 결제 조정 페이지에 액세스하려면 다음 안내를 따르세요.

apigee.com/edge에 로그인합니다.
게시 > 수익 창출 > 결제 조정을 클릭합니다.

결제 조정 페이지가 표시됩니다.

그림에 강조 표시된 것처럼 결제 조정 페이지에서는 다음 작업이 가능합니다.

현재 결제 조정 목록 보기
결제 조정 추가하기
결제 조정 수정
결제 조정 목록 검색

Classic Edge (Private Cloud)

기존 Edge UI를 사용하여 결제 조정 페이지에 액세스하려면 다음 안내를 따르세요.

http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
수익 창출 > 조정을 클릭합니다.

결제 조정 페이지에서는 다음 작업이 가능합니다.

현재 결제 조정 목록 보기
결제 조정 추가
결제 조정 수정
결제 조정 목록 검색

결제 조정 추가

결제 조정을 추가하려면 다음 단계를 따르세요.

결제 조정 페이지에 액세스합니다.
+ 조정을 클릭합니다.

다음 정보를 입력합니다.

필드	설명
이름	결제 문서에 표시될 설명이 포함된 이름입니다.
조정 %	조정 금액으로, 양수 또는 음수의 백분율로 표시됩니다. 양성 백분율은 해당 비율만큼 거래의 수익 공유 또는 수수료를 조정합니다. 백분율로 표시됩니다. 마이너스 조정은 거래할 수 있습니다. 양수 또는 음수의 10진수를 입력하세요. 소수점 이하 2자리까지).
결제 월	조정의 결제 월입니다. 드롭다운 목록에서 월을 선택합니다.
거래 유형	조정을 적용하려는 거래 유형입니다. 선택 값을 선택합니다. 전체 거래 요금 (모델 트랜잭션 청구) 구매 (수익 공유 모델 거래) 환불 (수익 공유 모델 거래)
제품	조정을 적용할 API 제품입니다. Google Cloud 콘솔의 여러 API 제품에 대한 단일 조정 입찰가 조정을 적용하려는 경우 여러 API 제품의 경우 각 제품에 대한 조정을 만듭니다. API 제품 선택 를 선택합니다.
개발자	조정을 적용하려는 개발자입니다. 이 모든 개발자에 대한 조정 (기본값) 또는 특정 개발자에게만 적용됩니다. '전체'를 Developers' 드롭다운 메뉴에서 특정 개발자를 선택합니다. 참고: 특정 개발자가 모든 개발자의 조정을 재정의합니다.

조정 만들기를 클릭합니다.

결제 조정 수정

결제 조정을 수정하는 방법은 다음과 같습니다.

결제 조정 페이지에 액세스합니다.
수정하려는 결제 조정 위에 커서를 놓고 작업 메뉴에서 를 클릭합니다.
필요에 따라 결제 조정을 업데이트합니다.
조정 업데이트를 클릭합니다.

API를 사용하여 결제 조정하기

다음 섹션에서는 API를 사용하여 결제를 조정하는 방법을 설명합니다.

API를 사용하여 결제 조정하기

POST 요청을 실행하여 결제 세부정보를 조정할 수 있습니다. /organizations/{org_name}/billing-adjustments. 요청할 때 요청 본문:

결제 조정의 이름입니다.
조정 백분율, 즉 청구 비용이 증가하거나 감소합니다
결제 월입니다.
청구 연도.
결제 조정이 적용되는 조직입니다.

다음과 같은 기타 속성을 지정할 수도 있습니다.

조정을 적용하려는 거래 유형 (예: 구매) 합니다.
조정을 적용하려는 개발자입니다.
선불 개발자, 후불 개발자 또는 있습니다
조정을 적용하려는 API 패키지입니다.
조정을 적용할 API 제품입니다.

전체 목록은 결제 조정 구성 설정을 참조하세요. 결제 조정 속성을 정의합니다.

선택사항인 속성을 지정하지 않으면 결제 문서 조정이 모두 적용됩니다. (해당 숙박 시설 포함) 예를 들어 거래 유형을 지정하지 않으면 조정사항이 모든 거래 유형에 적용됩니다.

다음 예에서는 2013년 6월의 미결제 청구 월의 결제를 조정합니다. 이 3% 감액 비율이며, 이는 구매 거래에 적용됩니다. 결제 제품, 후불 개발자 등이 있습니다. 특정 광고 단위를 식별하는 데 사용되는 개발자 또는 API 패키지가 지정되지 않은 경우 모든 개발자( 후불 개발자) 및 모든 API 패키지의 결제 제품입니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "name": "Purchase Adjustment Negative3",
  "adjustmentPercentageFactor": -3,
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
  },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \
-u email:password

응답은 다음과 같아야 합니다(응답의 일부만 표시됨).

{
  "adjustmentPercentageFactor" : -3,
  "billingMonth" : 6,
  "billingYear" : 2017,
  "developerBillingType" : "POSTPAID",
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
  "isPublished" : false,
  "name" : "Purchase Adjustment Negative3",
  "organization" : {
   ...
  },
  "product" : {
    "customAtt1Name" : "user",
    "description" : "Payment",
    "displayName" : "Payment",
    "id" : "payment",
    "name" : "payment",
    "organization" : {
      ...
    },
    "status" : "CREATED",
    "transactionSuccessCriteria" : "Status=='200 OK'"
  },
  "transactionType" : "PURCHASE"
}

API를 사용하여 결제 조정 보기

조직의 특정 결제 조정 또는 모든 결제 조정을 볼 수 있습니다. 특정 결제 조정을 보려면 GET 요청을 발행하세요. /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, 각 항목의 의미는 다음과 같습니다. {billing_adjustment_id}는 특정 결제 조정의 식별입니다. ID는 결제 조정을 만들 때 응답에 반환됩니다. 예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

조직의 모든 결제 조정을 보려면 GET 요청을 발행하세요. /organizations/{org_name}/billing-adjustments 예를 들면 다음과 같습니다.

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

응답은 다음과 같아야 합니다(응답의 일부만 표시됨).

{
  "billingAdjustment" : [ {
    "adjustmentPercentageFactor" : -3,
    "billingMonth" : 6,
    "billingYear" : 2017,
    "developerBillingType" : "POSTPAID",
    "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
    "isPublished" : false,
    "name" : "Purchase Adjustment Negative3",
    "organization" : {
      ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    },
    "transactionType" : "PURCHASE"
  }, {
    "adjustmentPercentageFactor" : 5.0000,
    "billingMonth" : 5,
    "billingYear" : 2017,
    "id" : "53c363c0-7e1d-4dc1-9392-cf86656225f2",
    "isPublished" : false,
    "monetizationPackage" : {
      "description" : "Communications",
      "displayName" : "Communications",
      "id" : "communications",
      "name" : "Communications",
      "organization" : {
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Messaging",
        "displayName" : "Messaging",
        "id" : "messaging",
        "name" : "messaging",
        "organization" : {
          ...
        },
        "status" : "CREATED"
      }, {
        ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Test Package Adjustment",
    "organization" : {
     ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    }
  } ],
  "totalRecords" : 2
}

API를 사용하여 결제 조정 업데이트

결제 조정을 업데이트하려면 /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, 각 항목의 의미는 다음과 같습니다. {billing_adjustment_id}는 특정 결제 조정의 식별입니다. 업데이트할 때 요청 본문에서 업데이트된 속성과 업데이트할 결제 조정의 ID입니다. 또한 필수 항목인 결제 조정의 속성, 즉 이름 속성, 조정 비율 결제 연도, 결제 연도, 조직입니다

예를 들어 다음 API 호출은 조정 비율 계수와 이름( 업데이트된 속성은 예시에 강조표시되어 있음).

$ curl -H "Content-Type: application/json" -X PUT -d \
'{
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c ",
  "adjustmentPercentageFactor": -5,
  "name" : "Purchase Adjustment Negative5",
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
    },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

API를 사용하여 결제 조정 삭제

DELETE 요청을 실행하여 결제 조정을 삭제할 수 있습니다. /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, 각 항목의 의미는 다음과 같습니다. {billing_adjustment_id}는 결제 조정의 식별입니다. 이(가) 삭제되었습니다. 예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

API의 결제 조정 구성 설정

결제 조정에 사용할 수 있는 구성 옵션은 다음과 같습니다.

이름	설명	기본값	필수 여부
`name`	결제 조정을 설명하는 이름입니다.	해당 사항 없음	예
`adjustmentPercentageFactor`	조정 금액으로, 양수 또는 음수의 백분율로 표시됩니다. 양성 백분율은 거래의 수익 공유 또는 수수료를 해당 비율만큼 조정합니다. 가 마이너스 비율은 해당 비율만큼 거래의 수익 공유 또는 수수료를 하향 조정 백분율로 표시됩니다. 값의 범위는 -100~999.9999입니다.	해당 사항 없음	예
`billingMonth`	결제 조정의 결제 월로, 정수로 지정됩니다. 예: 11 12월을 확인하세요.	해당 사항 없음	예
`billingYear`	결제 조정의 결제 연도로, 다음 형식을 사용하여 지정됩니다. YYYY입니다. 예: 2017	해당 사항 없음	예
`organization`	결제 조정이 적용되는 조직입니다.	해당 사항 없음	예
`isPublished`	조정을 게시해야 하는지 여부를 지정하는 플래그입니다. 값은 다음 중 하나입니다. `true` 결제 조정을 게시해야 합니다. `false` 결제 조정을 게시해서는 안 됩니다.	해당 사항 없음	아니요
`transactionType`	결제 조정이 적용되는 거래 유형입니다. 유형은 다음 중 하나입니다. `PURCHASE` `CHARGE` `REFUND` `CREDIT` `BALANCE` `SETUPFEES` `TERMINATIONFEES` `RECURRINGFEES` `TRUEUPS` 등급 조정에 사용되는 거래입니다. 거래입니다. 이전 청구에서 세금이 변경되면 호출됩니다. 월	해당 사항 없음	아니요
`developerBillingType`	결제 조정이 적용되는 개발자 결제 유형입니다. 값은 다음 중 하나: `PREPAID.` 선불 개발자. `POSTPAID` 후불 개발자 `BOTH` 선불 및 후불 개발자	해당 사항 없음	아니요
`product`	결제 조정이 적용되는 API 제품입니다. 특정 광고 단위를 결제 조정이 모든 API 제품에 적용됩니다. 참고: 여러 API에 단일 조정을 적용할 수 없습니다. 있습니다. 여러 API 제품에 조정을 적용해야 하는 경우 조정	해당 사항 없음	아니요
`monetizationPackage`	결제 조정이 적용되는 API 패키지입니다. 특정 광고 단위를 결제 조정이 모든 API 패키지에 적용됩니다. 참고: 여러 API에 단일 조정을 적용할 수 없습니다. 패키지입니다 여러 API 패키지에 조정을 적용해야 하는 경우 조정하시기 바랍니다.	해당 사항 없음	아니요
`developer`	결제 조정이 적용되는 개발자입니다. 이 필드를 지정하지 않는 경우 결제 조정이 모든 개발자에게 적용됩니다. 참고: 특정 개발자를 대상으로 하는 모든 조정 모든 개발자를 위한 조정사항보다 항상 우선 적용됩니다.	해당 사항 없음	아니요

다음 단계

수익 창출을 통해 개발자에게 크레딧을 유연하게 지급할 수 있습니다. 직접 수행해야 하는 작업 개발자가 서비스에 만족하지 못하고 사용에 대한 부분 또는 전액 환불을 요청하는 경우 확인할 수 있습니다 크레딧 발급에서 크레딧 발급 방법을 알아보세요.