Method: purchases.subscriptions.cancel

• HTTP 요청
• 경로 매개변수
• 요청 본문
  • JSON 표현
• 응답 본문
• 승인 범위
• CancellationType
• 사용해 보기

사용자의 정기 결제 구매를 취소합니다. 만료 시점까지 정기 결제는 계속 유효합니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

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

경로 매개변수

매개변수
packageName	string 이 정기 결제를 구매한 애플리케이션의 패키지 이름입니다 (예: 'com.some.thing').
subscriptionId	string 구매한 정기 결제 ID입니다 (예: 'monthly001').
token	string 정기 결제를 구매했을 때 사용자 기기에 제공된 토큰입니다.

요청 본문

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

JSON 표현
{ "cancellationType": enum (CancellationType) }

필드
cancellationType	enum (CancellationType) 선택사항입니다. 구매한 정기 결제의 취소 유형입니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

승인 범위

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

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

CancellationType

개발자가 요청한 취소 유형입니다.

열거형
CANCELLATION_TYPE_UNSPECIFIED	취소 유형이 지정되지 않았습니다.
USER_REQUESTED_STOP_RENEWALS	사용자가 취소를 요청했으며 정기 결제를 복원할 수 있습니다. 구독의 다음 갱신만 중지됩니다. 할부 정기 결제의 경우 사용자는 약정 기간을 완료해야 합니다. 갱신 및 결제에 관한 자세한 내용은 https://developer.android.com/google/play/billing/subscriptions#installments를 참고하세요.
DEVELOPER_REQUESTED_STOP_PAYMENTS	개발자가 취소를 요청했으며, 정기 결제를 복원할 수 없습니다. 구독의 다음 결제가 중지됩니다. 할부 정기 결제의 경우 사용자는 다음번 결제를 지불하고 약정 기간을 완료할 필요가 없습니다. 갱신 및 결제에 관한 자세한 내용은 https://developer.android.com/google/play/billing/subscriptions#installments를 참고하세요. 취소 유형을 지정하지 않은 경우 기본 동작입니다.