REST Resource: purchases.voidedpurchases

리소스: VoidedPurchase

VoidedPurchase 리소스는 취소/환불/지불 거절된 구매를 나타냅니다.

JSON 표현 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
필드
kind

string

이 종류는 androidpublisher 서비스의 무효화된 구매 객체를 나타냅니다.
purchaseToken

string

일회성 구매 또는 정기 결제를 고유하게 식별하는 토큰입니다. 정기 결제 갱신을 고유하게 식별하려면 orderId (이 API의 버전 3부터 사용 가능)를 사용하세요.
purchaseTimeMillis

string (int64 format)

구매가 이루어진 시간입니다 (단위: 1970년 1월 1일 에포크 이후 경과된 밀리초).
voidedTimeMillis

string (int64 format)

구매가 취소/환불/지불 거절된 시간입니다 (단위: 1970년 1월 1일 에포크 이후 경과된 밀리초).
orderId

string

일회성 구매, 정기 결제 구매 또는 정기 결제 갱신을 고유하게 식별하는 주문 ID입니다.
voidedSource

integer

무효화된 구매를 시작한 주체입니다. 가능한 값은 사용자 1. 2(Developer), Google
voidedReason

integer

구매가 무효화된 이유입니다. 가능한 값은 0(기타), 1(Remorse), 2(Not_received), 4(Defective), 4(Accidental_purchase), 5(Fraud), 6(Friendly_fraud), 8(Chargeback) Unacknowledged_purchase
voidedQuantity

integer

수량 기반 부분 환불의 결과로 무효화된 수량입니다. 수량 기반 부분 환불의 무효화된 구매는 includeQuantityBasedPartialRefund가 true로 설정된 경우에만 반환될 수 있습니다.

메서드

list

 취소, 환불 또는 지불 거절된 구매를 나열합니다.

오류 코드

이 리소스의 작업은 다음 HTTP 오류 코드를 반환합니다.

오류 코드 이유 설명 해상도
400 invalidValue 요청에 잘못된 값이 제공되었습니다. 잘못되었거나 유효하지 않은 구매 토큰에 대해 반환되는 경우가 많습니다. API 참조에 따라 요청 본문 또는 매개변수의 잘못된 필드 값을 수정합니다.
400 required 요청에 필수 필드 또는 매개변수가 누락되었습니다. API 문서를 참고하여 모든 필수 입력란과 매개변수가 포함되어 있는지 확인하세요.
403 userInsufficientPermission 사용자에게 요청된 작업을 수행할 수 있는 충분한 권한이 없습니다. 인증된 사용자에게 Google Play Console에서 필요한 권한이 있는지 확인합니다. 자세한 내용은 서비스 계정 사용을 참고하세요.
404 notFound 요청된 리소스를 찾을 수 없습니다. 식별자 (예: 구매 토큰, 패키지 이름, 제품 ID, 정기 결제 ID)가 올바른지 확인합니다.
409 concurrentUpdate 동시에 업데이트되고 있는 객체를 업데이트하려고 시도했습니다. 지수 백오프로 요청 재시도 동일한 리소스를 동시에 수정하지 마세요.
5xx Generic error Google Play 서버의 일반 오류입니다. 요청을 다시 시도하세요.

문제가 계속되면 Google Play 계정 관리자에게 문의하거나 지원 요청을 제출하세요. Play 상태 대시보드에서 알려진 서비스 중단이 있는지 확인해 보세요.