Delphi DLL Requires Chilkat v11.7.0+
Delphi DLL
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
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);