C++ Requires Chilkat v11.7.0+
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 C++ Downloads
#include <CkHttpCurl.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.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";
// Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
const char *operationId = "YOUR_SAVED_OPERATION_UUID";
CkHttpCurl curl;
CkStringBuilder cmd;
CkJsonObject json;
int replaced;
const char *invoiceId = "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"
cmd.SetString("curl -X GET \"https://api.stripe.com/v1/invoices/@ID@\"");
cmd.Append(" -u \"@KEY@:\"");
cmd.Append(" -H \"Stripe-Version: 2026-10-28.endive\"");
replaced = cmd.Replace("@ID@",invoiceId);
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;
}
if (json.stringOf("collection_method") != "send_invoice") {
std::cout << "Select an invoice intended for email collection." << "\r\n";
return;
}
if (json.stringOf("status") == "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"
cmd.SetString("curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/finalize\"");
cmd.Append(" -u \"@KEY@:\"");
cmd.Append(" -H \"Stripe-Version: 2026-10-28.endive\"");
cmd.Append(" -H \"Idempotency-Key: @OP@-finalize\"");
cmd.Append(" -d \"auto_advance=false\"");
replaced = cmd.Replace("@ID@",invoiceId);
replaced = cmd.Replace("@OP@",operationId);
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;
}
}
if (json.stringOf("status") != "open") {
std::cout << "Invoice is not open for collection: " << json.stringOf("status") << "\r\n";
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"
cmd.SetString("curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/send\"");
cmd.Append(" -u \"@KEY@:\"");
cmd.Append(" -H \"Stripe-Version: 2026-10-28.endive\"");
cmd.Append(" -H \"Idempotency-Key: @OP@-send\"");
replaced = cmd.Replace("@ID@",invoiceId);
replaced = cmd.Replace("@OP@",operationId);
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 << "number = " << json.stringOf("number") << "\r\n";
std::cout << "status = " << json.stringOf("status") << "\r\n";
std::cout << "hosted_invoice_url = " << json.stringOf("hosted_invoice_url") << "\r\n";
}