C Requires Chilkat v11.7.0+
C
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
#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);
}