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

PureBasic
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkHttpCurl.pb"

Procedure ChilkatExample()

    success.i = 0

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

    curl.i = CkHttpCurl::ckCreate()
    If curl.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    cmd.i = CkStringBuilder::ckCreate()
    If cmd.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    replaced.i

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

    businessName.i = CkStringBuilder::ckCreate()
    If businessName.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckSetString(businessName,"Acme & Sons")

    email.i = CkStringBuilder::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckSetString(email,"billing+east@example.com")

    accountRef.s = "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}"
    CkStringBuilder::ckSetString(cmd,"curl -X POST " + Chr(34) + "https://api.stripe.com/v1/customers" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -u " + Chr(34) + "@KEY@:" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -H " + Chr(34) + "Stripe-Version: 2026-10-28.endive" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -H " + Chr(34) + "Idempotency-Key: @OP@-customer" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -d " + Chr(34) + "name=@NAME@" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -d " + Chr(34) + "email=@EMAIL@" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -d " + Chr(34) + "metadata[account_ref]=@REF@" + Chr(34))
    replaced = CkStringBuilder::ckReplace(cmd,"@NAME@",CkStringBuilder::ckGetEncoded(businessName,"url_rfc3986","utf-8"))
    replaced = CkStringBuilder::ckReplace(cmd,"@EMAIL@",CkStringBuilder::ckGetEncoded(email,"url_rfc3986","utf-8"))
    replaced = CkStringBuilder::ckReplace(cmd,"@REF@",accountRef)
    replaced = CkStringBuilder::ckReplace(cmd,"@OP@",operationId)
    replaced = CkStringBuilder::ckReplace(cmd,"@KEY@",apiKey)
    success = CkHttpCurl::ckDoYourThing(curl,CkStringBuilder::ckGetAsString(cmd))
    If success <> 1
        Debug "No HTTP response. Chilkat failure code: " + Str(CkHttpCurl::ckFailReason(curl))
        CkHttpCurl::ckDispose(curl)
        CkStringBuilder::ckDispose(cmd)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(businessName)
        CkStringBuilder::ckDispose(email)
        ProcedureReturn
    EndIf

    success = CkHttpCurl::ckGetResponseJson(curl,json)
    If (CkHttpCurl::ckStatusCode(curl) <> 200) OR (success <> 1)
        Debug "Stripe HTTP " + Str(CkHttpCurl::ckStatusCode(curl)) + "  Request-Id: " + CkHttpCurl::ckGetResponseHeaderField(curl,"Request-Id")
        If success = 1
            Debug CkJsonObject::ckStringOf(json,"error.message")
        EndIf

        CkHttpCurl::ckDispose(curl)
        CkStringBuilder::ckDispose(cmd)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(businessName)
        CkStringBuilder::ckDispose(email)
        ProcedureReturn
    EndIf

    ;  Save this string on the existing billing account after a successful create.
    customerId.s = CkJsonObject::ckStringOf(json,"id")
    Debug "Stripe customer: " + customerId


    CkHttpCurl::ckDispose(curl)
    CkStringBuilder::ckDispose(cmd)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(businessName)
    CkStringBuilder::ckDispose(email)


    ProcedureReturn
EndProcedure