C Requires Chilkat v11.7.0+
C
Stripe: Draft an invoice and attach line items
See more Stripe Examples
Create a draft for a customer and attach a priced line item to that specific invoice.
Stripe documentation and cURL example
Chilkat C Downloads
#include <C_CkHttpCurl.h>
#include <C_CkStringBuilder.h>
#include <C_CkJsonObject.h>
void ChilkatSample(void)
{
BOOL success;
const char *apiKey;
const char *operationId;
HCkHttpCurl curl;
HCkStringBuilder cmd;
HCkJsonObject json;
int replaced;
const char *customerId;
const char *priceId;
const char *invoiceId;
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";
// Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
operationId = "YOUR_SAVED_OPERATION_UUID";
curl = CkHttpCurl_Create();
cmd = CkStringBuilder_Create();
json = CkJsonObject_Create();
customerId = "cus_FROM_BILLING_ACCOUNT";
priceId = "price_FROM_CATALOG";
// curl -X POST "https://api.stripe.com/v1/invoices" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive" \
// -H "Idempotency-Key: {operationId}-draft" \
// -d "customer={customerId}" \
// -d "collection_method=send_invoice" \
// -d "days_until_due=30" \
// -d "auto_advance=false" \
// -d "pending_invoice_items_behavior=exclude"
CkStringBuilder_SetString(cmd,"curl -X POST \"https://api.stripe.com/v1/invoices\"");
CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
CkStringBuilder_Append(cmd," -H \"Idempotency-Key: @OP@-draft\"");
CkStringBuilder_Append(cmd," -d \"customer=@CUSTOMER@\"");
CkStringBuilder_Append(cmd," -d \"collection_method=send_invoice\"");
CkStringBuilder_Append(cmd," -d \"days_until_due=30\"");
CkStringBuilder_Append(cmd," -d \"auto_advance=false\"");
CkStringBuilder_Append(cmd," -d \"pending_invoice_items_behavior=exclude\"");
replaced = CkStringBuilder_Replace(cmd,"@CUSTOMER@",customerId);
replaced = CkStringBuilder_Replace(cmd,"@OP@",operationId);
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);
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);
return;
}
invoiceId = CkJsonObject_stringOf(json,"id");
printf("Save draft invoice ID: %s\n",invoiceId);
// Attach this line to the draft. Use a distinct stable key per local line on retries.
// curl -X POST "https://api.stripe.com/v1/invoiceitems" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive" \
// -H "Idempotency-Key: {operationId}-line-1" \
// -d "invoice={invoiceId}" \
// -d "customer={customerId}" \
// -d "pricing[price]={priceId}" \
// -d "quantity=2"
CkStringBuilder_SetString(cmd,"curl -X POST \"https://api.stripe.com/v1/invoiceitems\"");
CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
CkStringBuilder_Append(cmd," -H \"Idempotency-Key: @OP@-line-1\"");
CkStringBuilder_Append(cmd," -d \"invoice=@INVOICE@\"");
CkStringBuilder_Append(cmd," -d \"customer=@CUSTOMER@\"");
CkStringBuilder_Append(cmd," -d \"pricing[price]=@PRICE@\"");
CkStringBuilder_Append(cmd," -d \"quantity=2\"");
replaced = CkStringBuilder_Replace(cmd,"@INVOICE@",invoiceId);
replaced = CkStringBuilder_Replace(cmd,"@CUSTOMER@",customerId);
replaced = CkStringBuilder_Replace(cmd,"@PRICE@",priceId);
replaced = CkStringBuilder_Replace(cmd,"@OP@",operationId);
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);
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);
return;
}
printf("invoice = %s\n",CkJsonObject_stringOf(json,"invoice"));
printf("id = %s\n",CkJsonObject_stringOf(json,"id"));
printf("amount = %s\n",CkJsonObject_stringOf(json,"amount"));
printf("currency = %s\n",CkJsonObject_stringOf(json,"currency"));
CkHttpCurl_Dispose(curl);
CkStringBuilder_Dispose(cmd);
CkJsonObject_Dispose(json);
}