[Bug]: customerEmail includes + sign in checkout URL

[kyleledbetter]

Description

Using params in a checkout URL with customerEmail breaks if the customerEmail uses a + sign like:
first+last@email.com gets "value is not a valid email address"

Current Behavior

Use a checkout URL like:
``/checkout?productId=${product.id}&customerEmail=${customerEmail}

Results in a server error:

GET /workspace/7b3c40be-7de0-4dd8-82f4-07ea5ebb0de0/settings/subscription/checkout?productId=000d235c-222d-44df-8f8b-adsfasdf&customerEmail=first+last%40email.com 500 in 1051ms                                                                                                                                      Error [HTTPValidationError]: API error occurred: {"detail":[{"loc":["body","CheckoutProductsCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutProductsCreate","products"],"msg":"Field required","type":"missing"},{"loc":["body","CheckoutProductCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutPriceCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutPriceCreate","product_price_id"],"msg":"Field required","type":"missing"}]}
    at <unknown> (HTTPValidationError: API error occurred: {"detail":[{"loc":["body","CheckoutProductsCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutProductsCreate","products"],"msg":"Field required","type":"missing"},{"loc":["body","CheckoutProductCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutPriceCreate","customer_email"],"msg":"value is not a valid email address: The email address contains invalid characters before the @-sign: SPACE.","type":"value_error"},{"loc":["body","CheckoutPriceCreate","product_price_id"],"msg":"Field required","type":"missing"}]}) {
  'data$': [Object],
  detail: [Array]
}                                                                                                                                                                                                                                   ⨯ [RangeError: Invalid status code: 0] {
  code: 'ERR_HTTP_INVALID_STATUS_CODE'
}
 ⨯ [RangeError: Invalid status code: 0] {
  code: 'ERR_HTTP_INVALID_STATUS_CODE'
}

Workaround

You can skip emails with a + sign but then the user has to fill it in during checkout. Not huge but would like it to work:

&customerExternalId=${workspaceId}${customerEmail.includes("+") ? ""  : `&customerEmail=${customerEmail}`

Environment:

Next: 15.2
React: 19
"@polar-sh/nextjs": "^0.4.0”
"@polar-sh/sdk": "^0.32.11”

---

[frankie567]

In a URL, the plus sign represents a space, so we get "first" as a value for the email.

You need to urlencode the plus sign so it's truly treated as the plus sign: first%2Blast@email.com

[kyleledbetter]

A great thanks @frankie567 since this will prob be common it might be nice to add to example code in the docs, appreciate the super quick response