Method: purchases.subscriptions.cancel

Tidak digunakan lagi: Gunakan purchases.subscriptionsv2.cancel sebagai gantinya. Membatalkan pembelian langganan pengguna. Langganan tetap berlaku hingga waktu berlakunya habis. 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 ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Nama paket aplikasi tempat langganan ini dibeli (misalnya, 'com.some.thing').
subscriptionId

string

Catatan: Sejak 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. Kolom ini 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. Pembatalan ini hanya menghentikan perpanjangan langganan berikutnya. Untuk langganan cicilan, pengguna masih harus menyelesaikan masa 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. Pembatalan ini menghentikan pembayaran langganan berikutnya. Untuk langganan cicilan, pengguna tidak perlu membayar pembayaran berikutnya dan menyelesaikan masa 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.