PowerShell Requires Chilkat v11.7.0+
PowerShell
Stripe: Preview a plan or seat change
See more Stripe Examples
Preview a seat or plan change and display its proration lines, total, and the timestamp to retain with the quote.
Stripe documentation and cURL example
Chilkat PowerShell Downloads
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"
$success = $false
# Requires an unlocked Chilkat bundle. See Global Unlock Sample.
# Supply a restricted sandbox key from merchant-controlled configuration.
$apiKey = "YOUR_STRIPE_TEST_KEY"
$curl = New-Object Chilkat.HttpCurl
$cmd = New-Object Chilkat.StringBuilder
$json = New-Object Chilkat.JsonObject
$subscriptionId = "sub_FROM_ACCOUNT"
$itemId = "si_SELECTED_ITEM"
$priceId = "price_FROM_CATALOG"
$now = New-Object Chilkat.CkDateTime
$now.SetFromCurrentSystemTime()
$prorationDate = $now.GetAsUnixTimeStr($false)
# curl -X POST "https://api.stripe.com/v1/invoices/create_preview" \
# -u "$STRIPE_API_KEY:" \
# -H "Stripe-Version: 2026-10-28.endive" \
# -d "subscription={subscriptionId}" \
# -d "subscription_details[items][0][id]={itemId}" \
# -d "subscription_details[items][0][price]={priceId}" \
# -d "subscription_details[items][0][quantity]=5" \
# -d "subscription_details[proration_behavior]=create_prorations" \
# -d "subscription_details[proration_date]={prorationDate}"
$cmd.SetString("curl -X POST `"https://api.stripe.com/v1/invoices/create_preview`"")
$cmd.Append(" -u `"@KEY@:`"")
$cmd.Append(" -H `"Stripe-Version: 2026-10-28.endive`"")
$cmd.Append(" -d `"subscription=@SUB@`"")
$cmd.Append(" -d `"subscription_details[items][0][id]=@ITEM@`"")
$cmd.Append(" -d `"subscription_details[items][0][price]=@PRICE@`"")
$cmd.Append(" -d `"subscription_details[items][0][quantity]=5`"")
$cmd.Append(" -d `"subscription_details[proration_behavior]=create_prorations`"")
$cmd.Append(" -d `"subscription_details[proration_date]=@DATE@`"")
$replaced = $cmd.Replace("@SUB@",$subscriptionId)
$replaced = $cmd.Replace("@ITEM@",$itemId)
$replaced = $cmd.Replace("@PRICE@",$priceId)
$replaced = $cmd.Replace("@DATE@",$prorationDate)
$replaced = $cmd.Replace("@KEY@",$apiKey)
$success = $curl.DoYourThing($cmd.GetAsString())
if ($success -ne $true) {
$("No HTTP response. Chilkat failure code: " + $curl.FailReason)
exit
}
$success = $curl.GetResponseJson($json)
if (($curl.StatusCode -ne 200) -or ($success -ne $true)) {
$("Stripe HTTP " + $curl.StatusCode + " Request-Id: " + $curl.GetResponseHeaderField("Request-Id"))
if ($success -eq $true) {
$($json.StringOf("error.message"))
}
exit
}
$("total = " + $json.StringOf("total"))
$("currency = " + $json.StringOf("currency"))
$("Save this preview time with the selected changes: " + $prorationDate)
$i = 0
while (($i -lt $json.SizeOfArray("lines.data"))) {
$json.I = $i
if ($json.BoolOf("lines.data[i].parent.subscription_item_details.proration") -eq $true) {
$($json.StringOf("lines.data[i].description") + " " + $json.StringOf("lines.data[i].amount"))
}
$i = $i + 1
}
if ($json.BoolOf("lines.has_more") -eq $true) {
$("Only the first page of preview lines is shown. The total covers all lines.")
}