Sample code for 30+ languages & platforms
C++ 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 C++ Downloads

C++
#include <CkHttpCurl.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.h>
#include <CkDateTime.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Requires an unlocked Chilkat bundle. See Global Unlock Sample.
    //  Supply a restricted sandbox key from merchant-controlled configuration.
    const char *apiKey = "YOUR_STRIPE_TEST_KEY";

    CkHttpCurl curl;
    CkStringBuilder cmd;
    CkJsonObject json;

    int replaced;

    const char *subscriptionId = "sub_FROM_ACCOUNT";

    const char *itemId = "si_SELECTED_ITEM";

    const char *priceId = "price_FROM_CATALOG";

    CkDateTime now;
    now.SetFromCurrentSystemTime();
    const char *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) {
        std::cout << "No HTTP response. Chilkat failure code: " << curl.get_FailReason() << "\r\n";
        return;
    }

    success = curl.GetResponseJson(json);
    if ((curl.get_StatusCode() != 200) || (success != true)) {
        std::cout << "Stripe HTTP " << curl.get_StatusCode() << "  Request-Id: " << curl.getResponseHeaderField("Request-Id") << "\r\n";
        if (success == true) {
            std::cout << json.stringOf("error.message") << "\r\n";
        }

        return;
    }

    std::cout << "total = " << json.stringOf("total") << "\r\n";
    std::cout << "currency = " << json.stringOf("currency") << "\r\n";

    std::cout << "Save this preview time with the selected changes: " << prorationDate << "\r\n";
    int i = 0;
    while ((i < json.SizeOfArray("lines.data"))) {
        json.put_I(i);
        if (json.BoolOf("lines.data[i].parent.subscription_item_details.proration") == true) {
            std::cout << json.stringOf("lines.data[i].description") << "  " << json.stringOf("lines.data[i].amount") << "\r\n";
        }

        i = i + 1;
    }

    if (json.BoolOf("lines.has_more") == true) {
        std::cout << "Only the first page of preview lines is shown. The total covers all lines." << "\r\n";
    }
    }