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

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

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

    int replaced;

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

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

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

    String 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) {
        System.out.println("No HTTP response. Chilkat failure code: " + curl.get_FailReason());
        return;
        }

    success = curl.GetResponseJson(json);
    if ((curl.get_StatusCode() != 200) || (success != true)) {
        System.out.println("Stripe HTTP " + curl.get_StatusCode() + "  Request-Id: " + curl.getResponseHeaderField("Request-Id"));
        if (success == true) {
            System.out.println(json.stringOf("error.message"));
            }

        return;
        }

    //  Save this string on the existing billing account after a successful create.
    String customerId = json.stringOf("id");
    System.out.println("Stripe customer: " + customerId);
  }
}