Sample code for 30+ languages & platforms
JavaScript Requires Chilkat v11.7.0+

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

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Requires an unlocked Chilkat bundle. See Global Unlock Sample.
//  Supply a restricted sandbox key from merchant-controlled configuration.
var apiKey = "YOUR_STRIPE_TEST_KEY";
//  Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
var operationId = "YOUR_SAVED_OPERATION_UUID";

var curl = new CkHttpCurl();
var cmd = new CkStringBuilder();
var json = new CkJsonObject();

var replaced;

var 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) {
    console.log("No HTTP response. Chilkat failure code: " + curl.FailReason);
    return;
}

success = curl.GetResponseJson(json);
if ((curl.StatusCode !== 200) || (success !== true)) {
    console.log("Stripe HTTP " + curl.StatusCode + "  Request-Id: " + curl.GetResponseHeaderField("Request-Id"));
    if (success == true) {
        console.log(json.StringOf("error.message"));
    }

    return;
}

if (json.StringOf("collection_method") !== "send_invoice") {
    console.log("Select an invoice intended for email collection.");
    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) {
        console.log("No HTTP response. Chilkat failure code: " + curl.FailReason);
        return;
    }

    success = curl.GetResponseJson(json);
    if ((curl.StatusCode !== 200) || (success !== true)) {
        console.log("Stripe HTTP " + curl.StatusCode + "  Request-Id: " + curl.GetResponseHeaderField("Request-Id"));
        if (success == true) {
            console.log(json.StringOf("error.message"));
        }

        return;
    }

}

if (json.StringOf("status") !== "open") {
    console.log("Invoice is not open for collection: " + json.StringOf("status"));
    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) {
    console.log("No HTTP response. Chilkat failure code: " + curl.FailReason);
    return;
}

success = curl.GetResponseJson(json);
if ((curl.StatusCode !== 200) || (success !== true)) {
    console.log("Stripe HTTP " + curl.StatusCode + "  Request-Id: " + curl.GetResponseHeaderField("Request-Id"));
    if (success == true) {
        console.log(json.StringOf("error.message"));
    }

    return;
}

console.log("number = " + json.StringOf("number"));
console.log("status = " + json.StringOf("status"));
console.log("hosted_invoice_url = " + json.StringOf("hosted_invoice_url"));