Method: externaltransactions.refundexternaltransaction

기존 외부 거래를 환불하거나 부분 환불합니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 환불될 외부 거래의 이름입니다. 형식: application/{packageName}/externalTransactions/{externalTransaction}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
필드
refundTime

string (Timestamp format)

필수 항목입니다. 거래가 환불된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

통합 필드 refund_type. 필수 항목입니다. 외부 거래 환불 유형입니다. refund_type은 다음 중 하나여야 합니다.
partialRefund

object (PartialRefund)

부분 환불입니다.

fullRefund

object (FullRefund)

전액 환불

응답 본문

성공한 경우 응답 본문에 ExternalTransaction의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

PartialRefund

거래의 부분 환불입니다.

JSON 표현
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
필드
refundId

string

필수 항목입니다. 이 부분 환불을 구분하는 고유 ID입니다. 환불이 완료되면 이후 동일한 ID를 사용하는 환불은 실패합니다. 개별 거래 1건에 대한 환불마다 고유해야 합니다.

refundPreTaxAmount

object (Price)

필수 항목입니다. 부분 환불의 세전 금액입니다. 거래의 나머지 세전 금액보다 적어야 합니다.

FullRefund

이 유형에는 필드가 없습니다.

거래의 나머지 금액을 전액 환불합니다.