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

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Requires an unlocked Chilkat bundle. See Global Unlock Sample.
//  Supply a restricted sandbox key from merchant-controlled configuration.
var apiKey = "YOUR_STRIPE_TEST_KEY";
//  Load the saved UUID for this operation. Reuse it only for a retry with identical inputs.
var operationId = "YOUR_SAVED_OPERATION_UUID";

var curl = new CkHttpCurl();
var cmd = new CkStringBuilder();
var json = new CkJsonObject();

var replaced;

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

var businessName = new CkStringBuilder();
businessName.SetString("Acme & Sons");

var email = new CkStringBuilder();
email.SetString("billing+east@example.com");

var 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 !== true) {
    console.log("No HTTP response. Chilkat failure code: " + curl.FailReason);
    return;
}

success = curl.GetResponseJson(json);
if ((curl.StatusCode !== 200) || (success !== true)) {
    console.log("Stripe HTTP " + curl.StatusCode + "  Request-Id: " + curl.GetResponseHeaderField("Request-Id"));
    if (success == true) {
        console.log(json.StringOf("error.message"));
    }

    return;
}

//  Save this string on the existing billing account after a successful create.
var customerId = json.StringOf("id");
console.log("Stripe customer: " + customerId);