Method: purchases.subscriptions.cancel

Membatalkan pembelian langganan pengguna. Langganan tetap valid hingga waktu habis masa berlakunya. Versi yang lebih baru tersedia di purchases.subscriptionsv2.cancel untuk dukungan library klien yang lebih baik.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Nama paket aplikasi yang langganannya ini dibeli (misalnya, 'com.some.thing').
subscriptionId

string

Catatan: Mulai 21 Mei 2025, subscriptionId tidak diperlukan, dan tidak direkomendasikan untuk langganan dengan add-on. ID langganan yang dibeli (misalnya, 'monthly001').
token

string

Token yang diberikan ke perangkat pengguna saat langganan dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "cancellationType": enum (CancellationType)
}
Kolom
cancellationType

enum (CancellationType)

Opsional. Jenis pembatalan untuk langganan yang dibeli. Perhatikan bahwa kolom ini hanya didukung dalam permintaan HTTP. Tidak tersedia di library klien. Pengguna library klien dapat menggunakan purchases.subscriptionsv2.cancel sebagai gantinya.

Isi respons

Jika berhasil, isi respons akan kosong.

Contoh

Berikut adalah contoh permintaan:

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"

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

CancellationType

Jenis pembatalan yang diminta oleh developer.

Enum
CANCELLATION_TYPE_UNSPECIFIED Jenis pembatalan tidak ditentukan.
USER_REQUESTED_STOP_RENEWALS Pembatalan diminta oleh pengguna, dan langganan dapat dipulihkan. Tindakan ini hanya menghentikan perpanjangan langganan berikutnya. Untuk langganan cicilan, pengguna tetap harus menyelesaikan periode komitmen. Untuk mengetahui detail selengkapnya tentang perpanjangan dan pembayaran, lihat https://developer.android.com/google/play/billing/subscriptions#installments
DEVELOPER_REQUESTED_STOP_PAYMENTS Pembatalan diminta oleh developer, dan langganan tidak dapat dipulihkan. Tindakan ini akan menghentikan pembayaran langganan berikutnya. Untuk langganan cicilan, pengguna tidak perlu membayar pembayaran berikutnya dan menyelesaikan periode komitmen. Untuk mengetahui detail selengkapnya tentang perpanjangan dan pembayaran, lihat https://developer.android.com/google/play/billing/subscriptions#installments. Ini adalah perilaku default jika tidak ada jenis pembatalan yang ditentukan.