POST /v1/customer_sessions
Creates a Customer Session object that includes a single-use client secret that you can use on your front-end to grant client-side API access for certain customer resources.
Servers
- https://api.stripe.com/
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/x-www-form-urlencoded" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
customer |
String | No |
The ID of an existing customer for which to create the Customer Session. |
expand[] |
Array | No |
Specifies which fields in the response should be expanded. |
customer_account |
String | No |
The ID of an existing Account for which to create the Customer Session. |
components |
Object | Yes |
Configuration for each component. At least 1 component must be enabled. |
components.buy_button |
Object | No | |
components.buy_button.enabled |
Boolean | Yes | |
components.pricing_table |
Object | No | |
components.pricing_table.enabled |
Boolean | Yes | |
components.mobile_payment_element |
Object | No | |
components.mobile_payment_element.enabled |
Boolean | Yes | |
components.mobile_payment_element.features |
Object | No | |
components.mobile_payment_element.features.payment_method_redisplay |
String | No |
Valid values:
|
components.mobile_payment_element.features.payment_method_save_allow_redisplay_override |
String | No |
Valid values:
|
components.mobile_payment_element.features.payment_method_save |
String | No |
Valid values:
|
components.mobile_payment_element.features.payment_method_allow_redisplay_filters[] |
Array | No | |
components.mobile_payment_element.features.payment_method_remove |
String | No |
Valid values:
|
components.customer_sheet |
Object | No | |
components.customer_sheet.enabled |
Boolean | Yes | |
components.customer_sheet.features |
Object | No | |
components.customer_sheet.features.payment_method_allow_redisplay_filters[] |
Array | No | |
components.customer_sheet.features.payment_method_remove |
String | No |
Valid values:
|
components.payment_element |
Object | No | |
components.payment_element.enabled |
Boolean | Yes | |
components.payment_element.features |
Object | No | |
components.payment_element.features.payment_method_redisplay |
String | No |
Valid values:
|
components.payment_element.features.payment_method_save_usage |
String | No |
Valid values:
|
components.payment_element.features.payment_method_save |
String | No |
Valid values:
|
components.payment_element.features.payment_method_redisplay_limit |
Integer | No | |
components.payment_element.features.payment_method_allow_redisplay_filters[] |
Array | No | |
components.payment_element.features.payment_method_remove |
String | No |
Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.