Unicode C Requires Chilkat v11.7.0+
Unicode C
Stripe: Finalize and email a reviewed invoice
See more Stripe Examples
Finalize a reviewed draft and send the open invoice by email. Stripe test mode returns the API result without delivering an email.
Stripe documentation and cURL example
Chilkat Unicode C Downloads
#include <C_CkHttpCurlW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkJsonObjectW.h>
void ChilkatSample(void)
{
BOOL success;
const wchar_t *apiKey;
const wchar_t *operationId;
HCkHttpCurlW curl;
HCkStringBuilderW cmd;
HCkJsonObjectW json;
int replaced;
const wchar_t *invoiceId;
success = FALSE;
// Requires an unlocked Chilkat bundle. See Global Unlock Sample.
// Supply a restricted sandbox key from merchant-controlled configuration.
apiKey = L"YOUR_STRIPE_TEST_KEY";
// Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
operationId = L"YOUR_SAVED_OPERATION_UUID";
curl = CkHttpCurlW_Create();
cmd = CkStringBuilderW_Create();
json = CkJsonObjectW_Create();
invoiceId = L"in_FROM_BILLING_RECORD";
// curl -X GET "https://api.stripe.com/v1/invoices/{invoiceId}" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive"
CkStringBuilderW_SetString(cmd,L"curl -X GET \"https://api.stripe.com/v1/invoices/@ID@\"");
CkStringBuilderW_Append(cmd,L" -u \"@KEY@:\"");
CkStringBuilderW_Append(cmd,L" -H \"Stripe-Version: 2026-10-28.endive\"");
replaced = CkStringBuilderW_Replace(cmd,L"@ID@",invoiceId);
replaced = CkStringBuilderW_Replace(cmd,L"@KEY@",apiKey);
success = CkHttpCurlW_DoYourThing(curl,CkStringBuilderW_getAsString(cmd));
if (success != TRUE) {
wprintf(L"No HTTP response. Chilkat failure code: %d\n",CkHttpCurlW_getFailReason(curl));
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
success = CkHttpCurlW_GetResponseJson(curl,json);
if ((CkHttpCurlW_getStatusCode(curl) != 200) || (success != TRUE)) {
wprintf(L"Stripe HTTP %d Request-Id: %s\n",CkHttpCurlW_getStatusCode(curl),CkHttpCurlW_getResponseHeaderField(curl,L"Request-Id"));
if (success == TRUE) {
wprintf(L"%s\n",CkJsonObjectW_stringOf(json,L"error.message"));
}
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
if (CkJsonObjectW_stringOf(json,L"collection_method") != L"send_invoice") {
wprintf(L"Select an invoice intended for email collection.\n");
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
if (CkJsonObjectW_stringOf(json,L"status") == L"draft") {
// curl -X POST "https://api.stripe.com/v1/invoices/{invoiceId}/finalize" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive" \
// -H "Idempotency-Key: {operationId}-finalize" \
// -d "auto_advance=false"
CkStringBuilderW_SetString(cmd,L"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/finalize\"");
CkStringBuilderW_Append(cmd,L" -u \"@KEY@:\"");
CkStringBuilderW_Append(cmd,L" -H \"Stripe-Version: 2026-10-28.endive\"");
CkStringBuilderW_Append(cmd,L" -H \"Idempotency-Key: @OP@-finalize\"");
CkStringBuilderW_Append(cmd,L" -d \"auto_advance=false\"");
replaced = CkStringBuilderW_Replace(cmd,L"@ID@",invoiceId);
replaced = CkStringBuilderW_Replace(cmd,L"@OP@",operationId);
replaced = CkStringBuilderW_Replace(cmd,L"@KEY@",apiKey);
success = CkHttpCurlW_DoYourThing(curl,CkStringBuilderW_getAsString(cmd));
if (success != TRUE) {
wprintf(L"No HTTP response. Chilkat failure code: %d\n",CkHttpCurlW_getFailReason(curl));
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
success = CkHttpCurlW_GetResponseJson(curl,json);
if ((CkHttpCurlW_getStatusCode(curl) != 200) || (success != TRUE)) {
wprintf(L"Stripe HTTP %d Request-Id: %s\n",CkHttpCurlW_getStatusCode(curl),CkHttpCurlW_getResponseHeaderField(curl,L"Request-Id"));
if (success == TRUE) {
wprintf(L"%s\n",CkJsonObjectW_stringOf(json,L"error.message"));
}
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
}
if (CkJsonObjectW_stringOf(json,L"status") != L"open") {
wprintf(L"Invoice is not open for collection: %s\n",CkJsonObjectW_stringOf(json,L"status"));
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
// Retry a send using the same saved operation UUID. Test mode sends no email.
// curl -X POST "https://api.stripe.com/v1/invoices/{invoiceId}/send" \
// -u "$STRIPE_API_KEY:" \
// -H "Stripe-Version: 2026-10-28.endive" \
// -H "Idempotency-Key: {operationId}-send"
CkStringBuilderW_SetString(cmd,L"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/send\"");
CkStringBuilderW_Append(cmd,L" -u \"@KEY@:\"");
CkStringBuilderW_Append(cmd,L" -H \"Stripe-Version: 2026-10-28.endive\"");
CkStringBuilderW_Append(cmd,L" -H \"Idempotency-Key: @OP@-send\"");
replaced = CkStringBuilderW_Replace(cmd,L"@ID@",invoiceId);
replaced = CkStringBuilderW_Replace(cmd,L"@OP@",operationId);
replaced = CkStringBuilderW_Replace(cmd,L"@KEY@",apiKey);
success = CkHttpCurlW_DoYourThing(curl,CkStringBuilderW_getAsString(cmd));
if (success != TRUE) {
wprintf(L"No HTTP response. Chilkat failure code: %d\n",CkHttpCurlW_getFailReason(curl));
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
success = CkHttpCurlW_GetResponseJson(curl,json);
if ((CkHttpCurlW_getStatusCode(curl) != 200) || (success != TRUE)) {
wprintf(L"Stripe HTTP %d Request-Id: %s\n",CkHttpCurlW_getStatusCode(curl),CkHttpCurlW_getResponseHeaderField(curl,L"Request-Id"));
if (success == TRUE) {
wprintf(L"%s\n",CkJsonObjectW_stringOf(json,L"error.message"));
}
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
return;
}
wprintf(L"number = %s\n",CkJsonObjectW_stringOf(json,L"number"));
wprintf(L"status = %s\n",CkJsonObjectW_stringOf(json,L"status"));
wprintf(L"hosted_invoice_url = %s\n",CkJsonObjectW_stringOf(json,L"hosted_invoice_url"));
CkHttpCurlW_Dispose(curl);
CkStringBuilderW_Dispose(cmd);
CkJsonObjectW_Dispose(json);
}