Sample code for 30+ languages & platforms
Xbase++ Requires Chilkat v11.7.0+

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 Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL cApiKey
LOCAL oCurl
LOCAL oCmd
LOCAL oJson
LOCAL nReplaced
LOCAL cSubscriptionId
LOCAL cItemId
LOCAL cPriceId
LOCAL oNow
LOCAL cProrationDate
LOCAL i

nSuccess := 0

//  Requires an unlocked Chilkat bundle. See Global Unlock Sample.
//  Supply a restricted sandbox key from merchant-controlled configuration.
cApiKey := "YOUR_STRIPE_TEST_KEY"

oCurl := CreateObject("Chilkat.HttpCurl")
oCmd := CreateObject("Chilkat.StringBuilder")
oJson := CreateObject("Chilkat.JsonObject")

cSubscriptionId := "sub_FROM_ACCOUNT"

cItemId := "si_SELECTED_ITEM"

cPriceId := "price_FROM_CATALOG"

oNow := CreateObject("Chilkat.CkDateTime")
oNow:SetFromCurrentSystemTime()
cProrationDate := oNow:GetAsUnixTimeStr(0)

//  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}"
oCmd:SetString('curl -X POST "https://api.stripe.com/v1/invoices/create_preview"')
oCmd:Append(' -u "@KEY@:"')
oCmd:Append(' -H "Stripe-Version: 2026-10-28.endive"')
oCmd:Append(' -d "subscription=@SUB@"')
oCmd:Append(' -d "subscription_details[items][0][id]=@ITEM@"')
oCmd:Append(' -d "subscription_details[items][0][price]=@PRICE@"')
oCmd:Append(' -d "subscription_details[items][0][quantity]=5"')
oCmd:Append(' -d "subscription_details[proration_behavior]=create_prorations"')
oCmd:Append(' -d "subscription_details[proration_date]=@DATE@"')
nReplaced := oCmd:Replace("@SUB@", cSubscriptionId)
nReplaced := oCmd:Replace("@ITEM@", cItemId)
nReplaced := oCmd:Replace("@PRICE@", cPriceId)
nReplaced := oCmd:Replace("@DATE@", cProrationDate)
nReplaced := oCmd:Replace("@KEY@", cApiKey)
nSuccess := oCurl:DoYourThing(oCmd:GetAsString())
IF (nSuccess != 1)
    ? "No HTTP response. Chilkat failure code: " + Str(oCurl:FailReason)
    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    oNow:destroy()
    RETURN
ENDIF

nSuccess := oCurl:GetResponseJson(oJson)
IF ((oCurl:StatusCode != 200) .OR. (nSuccess != 1))
    ? "Stripe HTTP " + Str(oCurl:StatusCode) + "  Request-Id: " + oCurl:GetResponseHeaderField("Request-Id")
    IF (nSuccess == 1)
        ? oJson:StringOf("error.message")
    ENDIF

    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    oNow:destroy()
    RETURN
ENDIF

? "total = " + oJson:StringOf("total")
? "currency = " + oJson:StringOf("currency")

? "Save this preview time with the selected changes: " + cProrationDate
i := 0
DO WHILE (i < oJson:SizeOfArray("lines.data"))
    oJson:I := i
    IF (oJson:BoolOf("lines.data[i].parent.subscription_item_details.proration") == 1)
        ? oJson:StringOf("lines.data[i].description") + "  " + oJson:StringOf("lines.data[i].amount")
    ENDIF

    i := i + 1
ENDDO
IF (oJson:BoolOf("lines.has_more") == 1)
    ? "Only the first page of preview lines is shown. The total covers all lines."
ENDIF

oCurl:destroy()
oCmd:destroy()
oJson:destroy()
oNow:destroy()