Xbase++ Requires Chilkat v11.7.0+
Xbase++
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
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()