PHP ActiveX Requires Chilkat v11.7.0+
PHP ActiveX
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 PHP ActiveX Downloads
<?php
$success = 0;
// 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 = new COM("Chilkat.HttpCurl");
$cmd = new COM("Chilkat.StringBuilder");
$json = new COM("Chilkat.JsonObject");
$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"
$cmd->SetString('curl -X GET \'https://api.stripe.com/v1/invoices/@ID@\'');
$cmd->Append(' -u \'@KEY@:\'');
$cmd->Append(' -H \'Stripe-Version: 2026-10-28.endive\'');
$replaced = $cmd->Replace('@ID@',$invoiceId);
$replaced = $cmd->Replace('@KEY@',$apiKey);
$success = $curl->DoYourThing($cmd->getAsString());
if ($success != 1) {
print 'No HTTP response. Chilkat failure code: ' . $curl->FailReason . "\n";
exit;
}
$success = $curl->GetResponseJson($json);
if (($curl->StatusCode != 200) or ($success != 1)) {
print 'Stripe HTTP ' . $curl->StatusCode . ' Request-Id: ' . $curl->getResponseHeaderField('Request-Id') . "\n";
if ($success == 1) {
print $json->stringOf('error.message') . "\n";
}
exit;
}
if ($json->stringOf('collection_method') != 'send_invoice') {
print 'Select an invoice intended for email collection.' . "\n";
exit;
}
if ($json->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"
$cmd->SetString('curl -X POST \'https://api.stripe.com/v1/invoices/@ID@/finalize\'');
$cmd->Append(' -u \'@KEY@:\'');
$cmd->Append(' -H \'Stripe-Version: 2026-10-28.endive\'');
$cmd->Append(' -H \'Idempotency-Key: @OP@-finalize\'');
$cmd->Append(' -d \'auto_advance=false\'');
$replaced = $cmd->Replace('@ID@',$invoiceId);
$replaced = $cmd->Replace('@OP@',$operationId);
$replaced = $cmd->Replace('@KEY@',$apiKey);
$success = $curl->DoYourThing($cmd->getAsString());
if ($success != 1) {
print 'No HTTP response. Chilkat failure code: ' . $curl->FailReason . "\n";
exit;
}
$success = $curl->GetResponseJson($json);
if (($curl->StatusCode != 200) or ($success != 1)) {
print 'Stripe HTTP ' . $curl->StatusCode . ' Request-Id: ' . $curl->getResponseHeaderField('Request-Id') . "\n";
if ($success == 1) {
print $json->stringOf('error.message') . "\n";
}
exit;
}
}
if ($json->stringOf('status') != 'open') {
print 'Invoice is not open for collection: ' . $json->stringOf('status') . "\n";
exit;
}
// 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"
$cmd->SetString('curl -X POST \'https://api.stripe.com/v1/invoices/@ID@/send\'');
$cmd->Append(' -u \'@KEY@:\'');
$cmd->Append(' -H \'Stripe-Version: 2026-10-28.endive\'');
$cmd->Append(' -H \'Idempotency-Key: @OP@-send\'');
$replaced = $cmd->Replace('@ID@',$invoiceId);
$replaced = $cmd->Replace('@OP@',$operationId);
$replaced = $cmd->Replace('@KEY@',$apiKey);
$success = $curl->DoYourThing($cmd->getAsString());
if ($success != 1) {
print 'No HTTP response. Chilkat failure code: ' . $curl->FailReason . "\n";
exit;
}
$success = $curl->GetResponseJson($json);
if (($curl->StatusCode != 200) or ($success != 1)) {
print 'Stripe HTTP ' . $curl->StatusCode . ' Request-Id: ' . $curl->getResponseHeaderField('Request-Id') . "\n";
if ($success == 1) {
print $json->stringOf('error.message') . "\n";
}
exit;
}
print 'number = ' . $json->stringOf('number') . "\n";
print 'status = ' . $json->stringOf('status') . "\n";
print 'hosted_invoice_url = ' . $json->stringOf('hosted_invoice_url') . "\n";
?>