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

Stripe: Review and update billing details

See more Stripe Examples

Retrieve a customer from its saved ID and update the billing email address.

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

    customerId.s = "cus_FROM_BILLING_ACCOUNT"

    ;  curl -X GET "https://api.stripe.com/v1/customers/{customerId}" \
    ;    -u "$STRIPE_API_KEY:" \
    ;    -H "Stripe-Version: 2026-10-28.endive"
    CkStringBuilder::ckSetString(cmd,"curl -X GET " + Chr(34) + "https://api.stripe.com/v1/customers/@ID@" + 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))
    replaced = CkStringBuilder::ckReplace(cmd,"@ID@",customerId)
    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)
        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)
        ProcedureReturn
    EndIf

    Debug "name = " + CkJsonObject::ckStringOf(json,"name")
    Debug "email = " + CkJsonObject::ckStringOf(json,"email")
    Debug "account_ref = " + CkJsonObject::ckStringOf(json,"metadata.account_ref")

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

    CkStringBuilder::ckSetString(newEmail,"accounts+receivable@example.com")

    ;  curl -X POST "https://api.stripe.com/v1/customers/{customerId}" \
    ;    -u "$STRIPE_API_KEY:" \
    ;    -H "Stripe-Version: 2026-10-28.endive" \
    ;    -H "Idempotency-Key: {operationId}-billing-email" \
    ;    -d "email={newEmail}"
    CkStringBuilder::ckSetString(cmd,"curl -X POST " + Chr(34) + "https://api.stripe.com/v1/customers/@ID@" + 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@-billing-email" + Chr(34))
    CkStringBuilder::ckAppend(cmd," -d " + Chr(34) + "email=@EMAIL@" + Chr(34))
    replaced = CkStringBuilder::ckReplace(cmd,"@ID@",customerId)
    replaced = CkStringBuilder::ckReplace(cmd,"@EMAIL@",CkStringBuilder::ckGetEncoded(newEmail,"url_rfc3986","utf-8"))
    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(newEmail)
        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(newEmail)
        ProcedureReturn
    EndIf

    Debug "id = " + CkJsonObject::ckStringOf(json,"id")
    Debug "email = " + CkJsonObject::ckStringOf(json,"email")


    CkHttpCurl::ckDispose(curl)
    CkStringBuilder::ckDispose(cmd)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(newEmail)


    ProcedureReturn
EndProcedure