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 <C_CkHttpCurl.h>
#include <C_CkStringBuilder.h>
#include <C_CkJsonObject.h>
#include <C_CkDateTime.h>

void ChilkatSample(void)
    {
    BOOL success;
    const char *apiKey;
    HCkHttpCurl curl;
    HCkStringBuilder cmd;
    HCkJsonObject json;
    int replaced;
    const char *subscriptionId;
    const char *itemId;
    const char *priceId;
    HCkDateTime now;
    const char *prorationDate;
    int i;

    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 = CkHttpCurl_Create();
    cmd = CkStringBuilder_Create();
    json = CkJsonObject_Create();

    subscriptionId = "sub_FROM_ACCOUNT";

    itemId = "si_SELECTED_ITEM";

    priceId = "price_FROM_CATALOG";

    now = CkDateTime_Create();
    CkDateTime_SetFromCurrentSystemTime(now);
    prorationDate = CkDateTime_getAsUnixTimeStr(now,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}"
    CkStringBuilder_SetString(cmd,"curl -X POST \"https://api.stripe.com/v1/invoices/create_preview\"");
    CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
    CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
    CkStringBuilder_Append(cmd," -d \"subscription=@SUB@\"");
    CkStringBuilder_Append(cmd," -d \"subscription_details[items][0][id]=@ITEM@\"");
    CkStringBuilder_Append(cmd," -d \"subscription_details[items][0][price]=@PRICE@\"");
    CkStringBuilder_Append(cmd," -d \"subscription_details[items][0][quantity]=5\"");
    CkStringBuilder_Append(cmd," -d \"subscription_details[proration_behavior]=create_prorations\"");
    CkStringBuilder_Append(cmd," -d \"subscription_details[proration_date]=@DATE@\"");
    replaced = CkStringBuilder_Replace(cmd,"@SUB@",subscriptionId);
    replaced = CkStringBuilder_Replace(cmd,"@ITEM@",itemId);
    replaced = CkStringBuilder_Replace(cmd,"@PRICE@",priceId);
    replaced = CkStringBuilder_Replace(cmd,"@DATE@",prorationDate);
    replaced = CkStringBuilder_Replace(cmd,"@KEY@",apiKey);
    success = CkHttpCurl_DoYourThing(curl,CkStringBuilder_getAsString(cmd));
    if (success != TRUE) {
        printf("No HTTP response. Chilkat failure code: %d\n",CkHttpCurl_getFailReason(curl));
        CkHttpCurl_Dispose(curl);
        CkStringBuilder_Dispose(cmd);
        CkJsonObject_Dispose(json);
        CkDateTime_Dispose(now);
        return;
    }

    success = CkHttpCurl_GetResponseJson(curl,json);
    if ((CkHttpCurl_getStatusCode(curl) != 200) || (success != TRUE)) {
        printf("Stripe HTTP %d  Request-Id: %s\n",CkHttpCurl_getStatusCode(curl),CkHttpCurl_getResponseHeaderField(curl,"Request-Id"));
        if (success == TRUE) {
            printf("%s\n",CkJsonObject_stringOf(json,"error.message"));
        }

        CkHttpCurl_Dispose(curl);
        CkStringBuilder_Dispose(cmd);
        CkJsonObject_Dispose(json);
        CkDateTime_Dispose(now);
        return;
    }

    printf("total = %s\n",CkJsonObject_stringOf(json,"total"));
    printf("currency = %s\n",CkJsonObject_stringOf(json,"currency"));

    printf("Save this preview time with the selected changes: %s\n",prorationDate);
    i = 0;
    while ((i < CkJsonObject_SizeOfArray(json,"lines.data"))) {
        CkJsonObject_putI(json,i);
        if (CkJsonObject_BoolOf(json,"lines.data[i].parent.subscription_item_details.proration") == TRUE) {
            printf("%s  %s\n",CkJsonObject_stringOf(json,"lines.data[i].description"),CkJsonObject_stringOf(json,"lines.data[i].amount"));
        }

        i = i + 1;
    }

    if (CkJsonObject_BoolOf(json,"lines.has_more") == TRUE) {
        printf("Only the first page of preview lines is shown. The total covers all lines.\n");
    }



    CkHttpCurl_Dispose(curl);
    CkStringBuilder_Dispose(cmd);
    CkJsonObject_Dispose(json);
    CkDateTime_Dispose(now);

    }