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

Xbase++
LOCAL nSuccess
LOCAL cApiKey
LOCAL cOperationId
LOCAL oCurl
LOCAL oCmd
LOCAL oJson
LOCAL nReplaced
LOCAL cInvoiceId

nSuccess := 0

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

oCurl := CreateObject("Chilkat.HttpCurl")
oCmd := CreateObject("Chilkat.StringBuilder")
oJson := CreateObject("Chilkat.JsonObject")

cInvoiceId := "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"
oCmd:SetString('curl -X GET "https://api.stripe.com/v1/invoices/@ID@"')
oCmd:Append(' -u "@KEY@:"')
oCmd:Append(' -H "Stripe-Version: 2026-10-28.endive"')
nReplaced := oCmd:Replace("@ID@", cInvoiceId)
nReplaced := oCmd:Replace("@KEY@", cApiKey)
nSuccess := oCurl:DoYourThing(oCmd:GetAsString())
IF (nSuccess != 1)
    ? "No HTTP response. Chilkat failure code: " + Str(oCurl:FailReason)
    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

nSuccess := oCurl:GetResponseJson(oJson)
IF ((oCurl:StatusCode != 200) .OR. (nSuccess != 1))
    ? "Stripe HTTP " + Str(oCurl:StatusCode) + "  Request-Id: " + oCurl:GetResponseHeaderField("Request-Id")
    IF (nSuccess == 1)
        ? oJson:StringOf("error.message")
    ENDIF

    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

IF (oJson:StringOf("collection_method") != "send_invoice")
    ? "Select an invoice intended for email collection."
    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

IF (oJson: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"
    oCmd:SetString('curl -X POST "https://api.stripe.com/v1/invoices/@ID@/finalize"')
    oCmd:Append(' -u "@KEY@:"')
    oCmd:Append(' -H "Stripe-Version: 2026-10-28.endive"')
    oCmd:Append(' -H "Idempotency-Key: @OP@-finalize"')
    oCmd:Append(' -d "auto_advance=false"')
    nReplaced := oCmd:Replace("@ID@", cInvoiceId)
    nReplaced := oCmd:Replace("@OP@", cOperationId)
    nReplaced := oCmd:Replace("@KEY@", cApiKey)
    nSuccess := oCurl:DoYourThing(oCmd:GetAsString())
    IF (nSuccess != 1)
        ? "No HTTP response. Chilkat failure code: " + Str(oCurl:FailReason)
        oCurl:destroy()
        oCmd:destroy()
        oJson:destroy()
        RETURN
    ENDIF

    nSuccess := oCurl:GetResponseJson(oJson)
    IF ((oCurl:StatusCode != 200) .OR. (nSuccess != 1))
        ? "Stripe HTTP " + Str(oCurl:StatusCode) + "  Request-Id: " + oCurl:GetResponseHeaderField("Request-Id")
        IF (nSuccess == 1)
            ? oJson:StringOf("error.message")
        ENDIF

        oCurl:destroy()
        oCmd:destroy()
        oJson:destroy()
        RETURN
    ENDIF

ENDIF

IF (oJson:StringOf("status") != "open")
    ? "Invoice is not open for collection: " + oJson:StringOf("status")
    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

//  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"
oCmd:SetString('curl -X POST "https://api.stripe.com/v1/invoices/@ID@/send"')
oCmd:Append(' -u "@KEY@:"')
oCmd:Append(' -H "Stripe-Version: 2026-10-28.endive"')
oCmd:Append(' -H "Idempotency-Key: @OP@-send"')
nReplaced := oCmd:Replace("@ID@", cInvoiceId)
nReplaced := oCmd:Replace("@OP@", cOperationId)
nReplaced := oCmd:Replace("@KEY@", cApiKey)
nSuccess := oCurl:DoYourThing(oCmd:GetAsString())
IF (nSuccess != 1)
    ? "No HTTP response. Chilkat failure code: " + Str(oCurl:FailReason)
    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

nSuccess := oCurl:GetResponseJson(oJson)
IF ((oCurl:StatusCode != 200) .OR. (nSuccess != 1))
    ? "Stripe HTTP " + Str(oCurl:StatusCode) + "  Request-Id: " + oCurl:GetResponseHeaderField("Request-Id")
    IF (nSuccess == 1)
        ? oJson:StringOf("error.message")
    ENDIF

    oCurl:destroy()
    oCmd:destroy()
    oJson:destroy()
    RETURN
ENDIF

? "number = " + oJson:StringOf("number")
? "status = " + oJson:StringOf("status")
? "hosted_invoice_url = " + oJson:StringOf("hosted_invoice_url")

oCurl:destroy()
oCmd:destroy()
oJson:destroy()