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

C
#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 *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();

    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"
    CkStringBuilder_SetString(cmd,"curl -X GET \"https://api.stripe.com/v1/invoices/@ID@\"");
    CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
    CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
    replaced = CkStringBuilder_Replace(cmd,"@ID@",invoiceId);
    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;
    }

    if (CkJsonObject_stringOf(json,"collection_method") != "send_invoice") {
        printf("Select an invoice intended for email collection.\n");
        CkHttpCurl_Dispose(curl);
        CkStringBuilder_Dispose(cmd);
        CkJsonObject_Dispose(json);
        return;
    }

    if (CkJsonObject_stringOf(json,"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"
        CkStringBuilder_SetString(cmd,"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/finalize\"");
        CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
        CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
        CkStringBuilder_Append(cmd," -H \"Idempotency-Key: @OP@-finalize\"");
        CkStringBuilder_Append(cmd," -d \"auto_advance=false\"");
        replaced = CkStringBuilder_Replace(cmd,"@ID@",invoiceId);
        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;
        }

    }

    if (CkJsonObject_stringOf(json,"status") != "open") {
        printf("Invoice is not open for collection: %s\n",CkJsonObject_stringOf(json,"status"));
        CkHttpCurl_Dispose(curl);
        CkStringBuilder_Dispose(cmd);
        CkJsonObject_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"
    CkStringBuilder_SetString(cmd,"curl -X POST \"https://api.stripe.com/v1/invoices/@ID@/send\"");
    CkStringBuilder_Append(cmd," -u \"@KEY@:\"");
    CkStringBuilder_Append(cmd," -H \"Stripe-Version: 2026-10-28.endive\"");
    CkStringBuilder_Append(cmd," -H \"Idempotency-Key: @OP@-send\"");
    replaced = CkStringBuilder_Replace(cmd,"@ID@",invoiceId);
    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("number = %s\n",CkJsonObject_stringOf(json,"number"));
    printf("status = %s\n",CkJsonObject_stringOf(json,"status"));
    printf("hosted_invoice_url = %s\n",CkJsonObject_stringOf(json,"hosted_invoice_url"));


    CkHttpCurl_Dispose(curl);
    CkStringBuilder_Dispose(cmd);
    CkJsonObject_Dispose(json);

    }