Sample code for 30+ languages & platforms
PHP ActiveX Requires Chilkat v11.7.0+

Stripe: Create a Stripe Customer for an Existing Billing Account

See more Stripe Examples

Create a Stripe Customer for a local billing account. Send its internal reference in metadata and read the customer ID to save with that account.

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");

//  For an account already linked to Stripe, reuse its saved customer ID.

$businessName = new COM("Chilkat.StringBuilder");
$businessName->SetString('Acme & Sons');

$email = new COM("Chilkat.StringBuilder");
$email->SetString('billing+east@example.com');

$accountRef = 'ACME-1042';

//  curl -X POST "https://api.stripe.com/v1/customers" \
//    -u "$STRIPE_API_KEY:" \
//    -H "Stripe-Version: 2026-10-28.endive" \
//    -H "Idempotency-Key: {operationId}-customer" \
//    -d "name={businessName}" \
//    -d "email={email}" \
//    -d "metadata[account_ref]={accountRef}"
$cmd->SetString('curl -X POST \'https://api.stripe.com/v1/customers\'');
$cmd->Append(' -u \'@KEY@:\'');
$cmd->Append(' -H \'Stripe-Version: 2026-10-28.endive\'');
$cmd->Append(' -H \'Idempotency-Key: @OP@-customer\'');
$cmd->Append(' -d \'name=@NAME@\'');
$cmd->Append(' -d \'email=@EMAIL@\'');
$cmd->Append(' -d \'metadata[account_ref]=@REF@\'');
$replaced = $cmd->Replace('@NAME@',$businessName->getEncoded('url_rfc3986','utf-8'));
$replaced = $cmd->Replace('@EMAIL@',$email->getEncoded('url_rfc3986','utf-8'));
$replaced = $cmd->Replace('@REF@',$accountRef);
$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;
}

//  Save this string on the existing billing account after a successful create.
$customerId = $json->stringOf('id');
print 'Stripe customer: ' . $customerId . "\n";

?>