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

Delphi DLL
var
success: Boolean;
apiKey: PWideChar;
operationId: PWideChar;
curl: HCkHttpCurl;
cmd: HCkStringBuilder;
json: HCkJsonObject;
replaced: Integer;
invoiceId: PWideChar;

begin
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) then
  begin
    Memo1.Lines.Add('No HTTP response. Chilkat failure code: ' + IntToStr(CkHttpCurl_getFailReason(curl)));
    Exit;
  end;
success := CkHttpCurl_GetResponseJson(curl,json);
if ((CkHttpCurl_getStatusCode(curl) <> 200) or (success <> True)) then
  begin
    Memo1.Lines.Add('Stripe HTTP ' + IntToStr(CkHttpCurl_getStatusCode(curl)) + '  Request-Id: ' + CkHttpCurl__getResponseHeaderField(curl,'Request-Id'));
    if (success = True) then
      begin
        Memo1.Lines.Add(CkJsonObject__stringOf(json,'error.message'));
      end;
    Exit;
  end;

if (CkJsonObject__stringOf(json,'collection_method') <> 'send_invoice') then
  begin
    Memo1.Lines.Add('Select an invoice intended for email collection.');
    Exit;
  end;
if (CkJsonObject__stringOf(json,'status') = 'draft') then
  begin
    //  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) then
      begin
        Memo1.Lines.Add('No HTTP response. Chilkat failure code: ' + IntToStr(CkHttpCurl_getFailReason(curl)));
        Exit;
      end;
    success := CkHttpCurl_GetResponseJson(curl,json);
    if ((CkHttpCurl_getStatusCode(curl) <> 200) or (success <> True)) then
      begin
        Memo1.Lines.Add('Stripe HTTP ' + IntToStr(CkHttpCurl_getStatusCode(curl)) + '  Request-Id: ' + CkHttpCurl__getResponseHeaderField(curl,'Request-Id'));
        if (success = True) then
          begin
            Memo1.Lines.Add(CkJsonObject__stringOf(json,'error.message'));
          end;
        Exit;
      end;
  end;
if (CkJsonObject__stringOf(json,'status') <> 'open') then
  begin
    Memo1.Lines.Add('Invoice is not open for collection: ' + CkJsonObject__stringOf(json,'status'));
    Exit;
  end;

//  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) then
  begin
    Memo1.Lines.Add('No HTTP response. Chilkat failure code: ' + IntToStr(CkHttpCurl_getFailReason(curl)));
    Exit;
  end;
success := CkHttpCurl_GetResponseJson(curl,json);
if ((CkHttpCurl_getStatusCode(curl) <> 200) or (success <> True)) then
  begin
    Memo1.Lines.Add('Stripe HTTP ' + IntToStr(CkHttpCurl_getStatusCode(curl)) + '  Request-Id: ' + CkHttpCurl__getResponseHeaderField(curl,'Request-Id'));
    if (success = True) then
      begin
        Memo1.Lines.Add(CkJsonObject__stringOf(json,'error.message'));
      end;
    Exit;
  end;

Memo1.Lines.Add('number = ' + CkJsonObject__stringOf(json,'number'));
Memo1.Lines.Add('status = ' + CkJsonObject__stringOf(json,'status'));
Memo1.Lines.Add('hosted_invoice_url = ' + CkJsonObject__stringOf(json,'hosted_invoice_url'));

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