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

PHP ActiveX
<?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";

?>