Sample code for 30+ languages & platforms
Unicode C++ 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

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkHttpCurlW.h>
#include <CkStringBuilderW.h>
#include <CkJsonObjectW.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 wchar_t *apiKey = L"YOUR_STRIPE_TEST_KEY";
    //  Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
    const wchar_t *operationId = L"YOUR_SAVED_OPERATION_UUID";

    CkHttpCurlW curl;
    CkStringBuilderW cmd;
    CkJsonObjectW json;

    int replaced;

    const wchar_t *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"
    cmd.SetString(L"curl -X GET \"https://api.stripe.com/v1/invoices/@ID@\"");
    cmd.Append(L" -u \"@KEY@:\"");
    cmd.Append(L" -H \"Stripe-Version: 2026-10-28.endive\"");
    replaced = cmd.Replace(L"@ID@",invoiceId);
    replaced = cmd.Replace(L"@KEY@",apiKey);
    success = curl.DoYourThing(cmd.getAsString());
    if (success != true) {
        wprintf(L"No HTTP response. Chilkat failure code: %d\n",curl.get_FailReason());
        return;
    }

    success = curl.GetResponseJson(json);
    if ((curl.get_StatusCode() != 200) || (success != true)) {
        wprintf(L"Stripe HTTP %d  Request-Id: %s\n",curl.get_StatusCode(),curl.getResponseHeaderField(L"Request-Id"));
        if (success == true) {
            wprintf(L"%s\n",json.stringOf(L"error.message"));
        }

        return;
    }

    if (json.stringOf(L"collection_method") != L"send_invoice") {
        wprintf(L"Select an invoice intended for email collection.\n");
        return;
    }

    if (json.stringOf(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"
        cmd.SetString(L"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/finalize\"");
        cmd.Append(L" -u \"@KEY@:\"");
        cmd.Append(L" -H \"Stripe-Version: 2026-10-28.endive\"");
        cmd.Append(L" -H \"Idempotency-Key: @OP@-finalize\"");
        cmd.Append(L" -d \"auto_advance=false\"");
        replaced = cmd.Replace(L"@ID@",invoiceId);
        replaced = cmd.Replace(L"@OP@",operationId);
        replaced = cmd.Replace(L"@KEY@",apiKey);
        success = curl.DoYourThing(cmd.getAsString());
        if (success != true) {
            wprintf(L"No HTTP response. Chilkat failure code: %d\n",curl.get_FailReason());
            return;
        }

        success = curl.GetResponseJson(json);
        if ((curl.get_StatusCode() != 200) || (success != true)) {
            wprintf(L"Stripe HTTP %d  Request-Id: %s\n",curl.get_StatusCode(),curl.getResponseHeaderField(L"Request-Id"));
            if (success == true) {
                wprintf(L"%s\n",json.stringOf(L"error.message"));
            }

            return;
        }

    }

    if (json.stringOf(L"status") != L"open") {
        wprintf(L"Invoice is not open for collection: %s\n",json.stringOf(L"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(L"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/send\"");
    cmd.Append(L" -u \"@KEY@:\"");
    cmd.Append(L" -H \"Stripe-Version: 2026-10-28.endive\"");
    cmd.Append(L" -H \"Idempotency-Key: @OP@-send\"");
    replaced = cmd.Replace(L"@ID@",invoiceId);
    replaced = cmd.Replace(L"@OP@",operationId);
    replaced = cmd.Replace(L"@KEY@",apiKey);
    success = curl.DoYourThing(cmd.getAsString());
    if (success != true) {
        wprintf(L"No HTTP response. Chilkat failure code: %d\n",curl.get_FailReason());
        return;
    }

    success = curl.GetResponseJson(json);
    if ((curl.get_StatusCode() != 200) || (success != true)) {
        wprintf(L"Stripe HTTP %d  Request-Id: %s\n",curl.get_StatusCode(),curl.getResponseHeaderField(L"Request-Id"));
        if (success == true) {
            wprintf(L"%s\n",json.stringOf(L"error.message"));
        }

        return;
    }

    wprintf(L"number = %s\n",json.stringOf(L"number"));
    wprintf(L"status = %s\n",json.stringOf(L"status"));
    wprintf(L"hosted_invoice_url = %s\n",json.stringOf(L"hosted_invoice_url"));
    }