Perbarui langganan

curl --request PATCH \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId}/subscriptions/{subscriptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "pause",
  "product_quantities": {
    "locations": 20,
    "users": 100
  },
  "add_products": {
    "sso": 1
  },
  "remove_products": [
    "sso"
  ],
  "metadata": {
    "project_id": "proj_def456"
  }
}'

{
  "id": "sub_a1b2c3d4e5f6g7h8",
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "status": "active",
  "currency": "usd",
  "product_quantities": {
    "locations": {
      "price_id": "price_123abc",
      "quantity": 10,
      "interval": "month"
    },
    "users": {
      "price_id": "price_456def",
      "quantity": 50,
      "interval": "month"
    }
  },
  "metadata": {
    "order_id": "6735"
  },
  "current_period_start": "2025-10-15T00:00:00Z",
  "current_period_end": "2025-11-15T00:00:00Z",
  "created_at": "2025-10-15T12:30:00Z",
  "updated_at": "2025-10-20T09:00:00Z"
}

PATCH

workspaces

{workspaceId}

billing-accounts

{billingAccountId}

subscriptions

{subscriptionId}

Perbarui langganan

curl --request PATCH \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId}/subscriptions/{subscriptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "pause",
  "product_quantities": {
    "locations": 20,
    "users": 100
  },
  "add_products": {
    "sso": 1
  },
  "remove_products": [
    "sso"
  ],
  "metadata": {
    "project_id": "proj_def456"
  }
}'

{
  "id": "sub_a1b2c3d4e5f6g7h8",
  "billing_account_id": "cus_a1b2c3d4e5f6g7h8",
  "status": "active",
  "currency": "usd",
  "product_quantities": {
    "locations": {
      "price_id": "price_123abc",
      "quantity": 10,
      "interval": "month"
    },
    "users": {
      "price_id": "price_456def",
      "quantity": 50,
      "interval": "month"
    }
  },
  "metadata": {
    "order_id": "6735"
  },
  "current_period_start": "2025-10-15T00:00:00Z",
  "current_period_end": "2025-11-15T00:00:00Z",
  "created_at": "2025-10-15T12:30:00Z",
  "updated_at": "2025-10-20T09:00:00Z"
}

Authorizations

Authorization

string

header

required

Masukkan JWT Anda dalam format: Bearer {token}

Path Parameters

workspaceId

string

required

ID dari workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

billingAccountId

string

required

ID dari akun penagihan, yang sesuai dengan ID Pelanggan Stripe (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

subscriptionId

string

required

ID dari langganan Stripe (sub_...).

Example:

"sub_a1b2c3d4e5f6g7h8"

Body

application/json

Tentukan salah satu dari operasi berikut: action, product_quantities, add_products, atau remove_products. metadata dapat digabungkan dengan product_quantities.

action

enum<string>

Lakukan tindakan perubahan status pada langganan.

Opsi yang tersedia:

pause,

resume,

sync

product_quantities

object

Ganti semua kuantitas produk saat ini dengan set baru ini. Untuk menghapus produk, hilangkan dari objek ini. quantity 0 tidak diizinkan; hilangkan kunci untuk menghapus.

Tampilkan atribut turunan

Example:

{ "locations": 20, "users": 100 }

add_products

object

Tambahkan produk baru ke langganan atau tingkatkan kuantitas yang sudah ada.

Tampilkan atribut turunan

Example:

{ "sso": 1 }

remove_products

enum<string>[]

Daftar jenis produk yang akan dihapus dari langganan.

Tampilkan atribut turunan

Example:

["sso"]

metadata

object

Satu set pasangan kunci-nilai untuk disimpan dengan langganan. Akan digabungkan dengan metadata yang ada.

Example:

{ "project_id": "proj_def456" }

Response

Langganan berhasil diperbarui.

string

Pengidentifikasi unik untuk langganan (ID Langganan Stripe), diawali dengan sub_.

Example:

"sub_a1b2c3d4e5f6g7h8"

billing_account_id

string

ID dari akun penagihan tempat langganan ini berada.

Example:

"cus_a1b2c3d4e5f6g7h8"

status

enum<string>

Status langganan.

Opsi yang tersedia:

active,

past_due,

unpaid,

canceled,

incomplete,

incomplete_expired,

trialing,

paused

Example:

"active"

currency

enum<string>

Kode mata uang ISO tiga huruf untuk langganan.

Opsi yang tersedia:

usd,

zar,

eur,

gbp,

aud

Example:

"usd"

product_quantities

object

Peta jenis produk yang dapat diukur ke kuantitas langganan dan detail harga mereka.

Tampilkan atribut turunan

Example:

{
  "locations": {
    "price_id": "price_123abc",
    "quantity": 10,
    "interval": "month"
  },
  "users": {
    "price_id": "price_456def",
    "quantity": 50,
    "interval": "month"
  }
}

metadata

object

Satu set pasangan kunci-nilai yang dapat Anda lampirkan ke sebuah objek.

Tampilkan atribut turunan

Example:

{ "order_id": "6735" }

current_period_start

string<date-time> | null

Awal periode penagihan saat ini.

Example:

"2025-10-15T00:00:00Z"

current_period_end

string<date-time> | null

Akhir periode penagihan saat ini.

Example:

"2025-11-15T00:00:00Z"

created_at

string<date-time> | null

Stempel waktu saat langganan dibuat.

Example:

"2025-10-15T12:30:00Z"

updated_at

string<date-time> | null

Stempel waktu saat langganan terakhir diperbarui di sistem kami.

Example:

"2025-10-20T09:00:00Z"

Batalkan langganan

Sebelumnya

Periksa kelayakan uji coba

Selanjutnya

⌘I

Mulai

Platform & Identitas

Manajemen & Orkestrasi Perangkat

Otomatisasi & AI

Layanan Jaringan & Konektivitas

Keamanan & Manajemen Ancaman

Pemantauan & Analitik

Layanan & Utilitas Inti

Perbarui langganan

Authorizations

Path Parameters

Body

Response