Method: purchases.subscriptions.cancel

지원 중단됨: 대신 purchases.subscriptionsv2.cancel을 사용하세요. 사용자의 정기 결제 구매를 취소합니다. 정기 결제는 만료 시간까지 유효합니다. 더 나은 클라이언트 라이브러리 지원을 위해 purchases.subscriptionsv2.cancel에서 최신 버전을 사용할 수 있습니다.

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

참고: 2025년 5월 21일부터 subscriptionId는 필수가 아니며 부가기능이 있는 정기 결제에는 권장되지 않습니다. 구매한 정기 결제 ID입니다 (예: 'monthly001').
token

string

정기 결제가 구매되었을 때 사용자 기기에 제공된 토큰입니다.

요청 본문

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

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

enum (CancellationType)

선택사항입니다. 구매한 정기 결제의 취소 유형입니다. 이 필드는 HTTP 요청에서만 지원됩니다. 클라이언트 라이브러리에서는 사용할 수 없습니다. 클라이언트 라이브러리 사용자는 대신 purchases.subscriptionsv2.cancel을 사용할 수 있습니다.

응답 본문

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

샘플

다음은 샘플 요청입니다.

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

승인 범위

다음 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를 참고하세요. 취소 유형이 지정되지 않은 경우 기본 동작입니다.