Python Requires Chilkat v11.7.0+
Python
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 Python Downloads
import sys
import chilkat2
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 = chilkat2.HttpCurl()
cmd = chilkat2.StringBuilder()
json = chilkat2.JsonObject()
subscriptionId = "sub_FROM_ACCOUNT"
itemId = "si_SELECTED_ITEM"
priceId = "price_FROM_CATALOG"
now = chilkat2.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 != True):
print("No HTTP response. Chilkat failure code: " + str(curl.FailReason))
sys.exit()
success = curl.GetResponseJson(json)
if ((curl.StatusCode != 200) or (success != True)):
print("Stripe HTTP " + str(curl.StatusCode) + " Request-Id: " + curl.GetResponseHeaderField("Request-Id"))
if (success == True):
print(json.StringOf("error.message"))
sys.exit()
print("total = " + json.StringOf("total"))
print("currency = " + json.StringOf("currency"))
print("Save this preview time with the selected changes: " + prorationDate)
i = 0
while (i < json.SizeOfArray("lines.data")) :
json.I = i
if (json.BoolOf("lines.data[i].parent.subscription_item_details.proration") == True):
print(json.StringOf("lines.data[i].description") + " " + json.StringOf("lines.data[i].amount"))
i = i + 1
if (json.BoolOf("lines.has_more") == True):
print("Only the first page of preview lines is shown. The total covers all lines.")