Method: purchases.subscriptions.cancel

Membatalkan pembelian langganan pengguna. Langganan tetap valid hingga waktu habis masa berlakunya.

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. Library ini tidak tersedia di library klien.

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 akan menghentikan perpanjangan langganan berikutnya. Untuk langganan cicilan, pengguna masih 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 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.