Method: externaltransactions.refundexternaltransaction

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

HTTP 요청

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

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 환불할 외부 거래의 이름입니다. 형식: applications/{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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
통합 필드 refund_type. 필수 항목입니다. 외부 거래 환불 유형입니다. refund_type은 다음 중 하나여야 합니다.
partialRefund

object (PartialRefund)

부분 환불입니다.
fullRefund

object (FullRefund)

전액 환불입니다.

응답 본문

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

샘플

다음은 샘플 요청입니다.

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/foo:refund' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "partialRefund": { \
      "refundId": "my_refund_id", \
      "refundPreTaxAmount": { \
        "currency": "USD", \
        "priceMicros": "10120000" \
      } \
    }, \
    "refundTime": "2023-10-20T16:43:32.852Z" \
  }'

다음은 샘플 응답입니다.

{
  "externalTransactionId": "1234567890123456789012345678901234567890123456789012345678901234",
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "1990000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "11400000"
  },
  "packageName": "com.example.app",
  "transactionState": "TRANSACTION_CANCELED",
  "transactionTime": "2023-04-01T12:00:00Z",
  "userTaxAddress": {
    "regionCode": "US"
  },
  "createTime": "2023-04-01T11:55:00Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "testPurchase": {},
  "recurringTransaction": {
    "initialExternalTransactionId": "9876543210987654321098765432109876543210987654321098765432109876",
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    }
  }
}

승인 범위

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

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

PartialRefund

거래의 부분 환불입니다.

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

string

필수 항목입니다. 이 부분 환불을 구별하는 고유 ID입니다. 환불이 완료되면 동일한 ID의 후속 환불은 실패합니다. 하나의 개별 거래 환불에서 고유해야 합니다.
refundPreTaxAmount

object (Price)

필수 항목입니다. 세전 부분 환불 금액입니다. 남은 세전 거래 금액보다 적어야 합니다.

FullRefund

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

남은 거래 금액의 전액 환불입니다.