환불 처리

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

소개

수익 창출을 사용하면 '구매 거래'에 대해 개발자에게 환불을 게시할 수 있습니다. 예를 들어 개발자가 결제 API를 제공하여 모바일 가입자에게 요금을 애플리케이션 또는 애플리케이션 내의 콘텐츠 구매 구독자가 API를 사용할 때마다 그것은 구매 거래입니다

구매 거래는 환불될 수 있습니다. 예를 들어 콘텐츠가 전송되지 않았을 수 있습니다. 제3자가 구매에 대해 만족하지 못하는 경우 이 경우 개발자는 서드 파티에 환불하는 경우 수익 창출을 통해 유사한 환불을 처리할 수 있습니다. 이것은 특히 수익 배분 계획과 관련된 제품입니다.

모바일 구독자에게 환불을 제공한 개발자가 수익을 구매했다고 가정해 보겠습니다. 계획을 공유할 수 있습니다 계획에서 개발자에게 구매 거래의 순/총 가격입니다. 환불을 게시하면 해당 월에 개발자에게 지급해야 할 결제 금액에서 70% 를 공제하는 경우 (환불이 적용된 달은 실제 환불된 달과 다를 수 있음) 구매 거래 발생)

기본 Edge UI를 사용하여 환불 게시 (Private Cloud용 Edge만 해당)

'성공'한 항목 모두에 대해 환불을 게시할 수 있습니다. 즉 API가 아직 전체 금액을 청구하지 않은 경우 환불. 환불을 게시하면 부모와의 환불 거래가 생성됩니다. 거래 ID로, 여기서 거래 ID는 구매 거래의 ID입니다.

원래 구매 거래의 전체 금액 또는 부분 금액. 부분 환불을 여러 개 게시할 수도 있지만 전체 환불 금액을 은(는) 원래 구매액을 초과할 수 없습니다.

환불을 게시하려면 다음 단계를 따르세요.

  1. '수익 창출' 탭에서 '환불'을 선택합니다.

    환불 페이지가 열립니다.

  2. 결제 월 드롭다운 메뉴에서 구매가 이루어진 월을 선택합니다. 일어난 일이었습니다 그런 다음 + 환불을 클릭합니다.

    이렇게 하면 선택한 항목의 모든 완료된 구매 거래 목록이 표시됩니다. 월

    개발자 이름 또는 실제 앱 세부정보에서 검색하여 환불 목록을 필터링할 수 있습니다. 발생합니다

    개발자별로 필터링하려면 개발자 드롭다운 메뉴에서 개발자를 선택합니다. 이 선택한 개발자와 관련된 거래 목록만 표시됩니다.

    거래 ID로 필터링하려면 원래 구매의 거래 ID를 입력하세요. 있습니다. 그러면 해당 ID에 대한 거래가 반환됩니다.

  3. 환불하려는 거래 행에서 선택 체크박스를 선택합니다.
  4. 유형 메뉴에서 전체 또는 부분 을 선택합니다.

    합계를 선택하면 구매 총액이 환불됩니다. 선택 항목 구매 금액의 일부만 환불됩니다.

    부분 환불을 선택한 경우 금액 입력란에 부분 환불 금액을 입력합니다. 다음과 같은 작업을 할 수 있습니다. 총 구매 금액까지만 환불합니다. 이미 게시글의 일부를 게시한 경우 구매 금액 한도까지만 입력할 수 있습니다. 또한 원래 구매 거래에 총 가격과 순 가격이 모두 있는 경우 환불하려는 부분 금액이 총금액인지 순금액인지 여부

  5. 환불을 처리하려면 '저장'을 클릭하고 취소하려면 '취소'를 클릭합니다.

    결제 월이 아직 남아 있는 경우 최초 구매의 달에 환불 금액이 게시됩니다. 그렇지 않으면 환불은 현재 날짜에 게시됩니다.

    부분 환불의 경우 일부 금액과 수익 공유 금액이 환불됩니다. 전체 금액 대비 부분 금액의 비율에 따라 공제됩니다. 위의 부분 환불 예에서 부분 금액은 총 가격의 0.50/1.12 = 45% 이므로 개발자의 수익 공유 금액에서 45% 가 공제됩니다.

UI에서 환불이 처리되었는지 확인 처리됨

계정 상단에서 결제 월을 선택하면 환불이 처리되었는지 확인할 수 있습니다. 환불 페이지로 이동합니다. 결제 월이 아직 열려 있는 경우 구매한 월입니다. 또는 청구 월이 종료된 경우 해당 월입니다. 이렇게 하면 개의 게시물입니다.

API를 사용하여 환불 게시

환불을 게시하려면 POST 요청을 발행하세요. /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, 여기서 {package_id}는 환불이 이루어지는 API 패키지의 ID입니다. 적용됩니다.

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

  • 환불되는 구매 거래의 식별 정보
  • 구매 거래의 수익 유형 (GROSS 또는 NET)입니다.
  • 환불 금액입니다.
  • 환불 사유를 설명하는 메모

원하는 경우 환불이 이루어지는 API 패키지를 URL 매개변수로 식별할 수 있습니다. 적용됩니다.

URL의 전체 목록은 환불 구성 설정을 참조하세요. 환불 요청에서 지정할 수 있는 매개변수가 있습니다.

예를 들어 다음 요청은 구매 거래의 환불을 처리합니다. 환불 금액은 총 구매 거래 금액의 50% 입니다.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

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

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

API의 환불 구성 설정

환불 요청에 다음 쿼리 매개변수를 지정할 수 있습니다.

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

환불이 적용되는 API 패키지입니다.

해당 사항 없음 아니요
parentTxId

환불할 구매 거래입니다.

해당 사항 없음
revenueType

구매의 수익 유형 (GROSS 또는 NET)입니다. 발생합니다

해당 사항 없음
refundAmount

환불 금액입니다.

해당 사항 없음
transactionNote

환불 사유를 설명하는 텍스트 메모

해당 사항 없음

다음 단계

수익 창출 관련 작업을 예약하는 방법 및 예약된 작업을 알아봅니다. 자동 예약 수익 창출 채용정보를 참조하세요.