Home / Servers / Stripe API / post_checkout_sessions
Create a Checkout Session
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Create a Checkout Session Creates a Checkout Session object. [POST /v1/checkout/sessions]
Name on the gateway: stripe_api__post_checkout_sessions · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
adaptive_pricing | object | Settings for price localization with Adaptive Pricing. |
after_expiration | object | Configure actions after a Checkout Session has expired. You can't set this… |
allow_promotion_codes | boolean | Enables user redeemable promotion codes. |
allowed_payment_method_types | array | A list of the types of payment methods (e.g., card) this Checkout Session can… |
automatic_tax | object | Settings for automatic tax lookup for this session and resulting payments… |
billing_address_collection | auto | required | Specify whether Checkout should collect the customer's billing address.… |
branding_settings | object | The branding settings for the Checkout Session. This parameter is not allowed… |
cancel_url | string | If set, Checkout displays a back button and customers will be directed to this… |
client_reference_id | string | A unique string to reference the Checkout Session. This can be a customer ID… |
consent_collection | object | Configure fields for the Checkout Session to gather active consent from… |
currency | string | Three-letter ISO currency code, in lowercase. Must be a supported currency.… |
custom_fields | array | Collect additional information from your customer using custom fields. Up to 3… |
custom_text | object | Display additional text for your customers using custom text. You can't set… |
customer | string | ID of an existing Customer, if one exists. In payment mode, the customer’s… |
customer_account | string | ID of an existing Account, if one exists. Has the same behavior as customer. |
customer_creation | always | if_required | Configure whether a Checkout Session creates a Customer during Session… |
customer_email | string | If provided, this value will be used when the Customer object is created. If… |
customer_update | object | Controls what fields on Customer can be updated by the Checkout Session. Can… |
discounts | array | The coupon or promotion code to apply to this Session. Currently, only up to… |
excluded_payment_method_types | array | A list of the types of payment methods (e.g., card) that should be excluded… |
expand | array | Specifies which fields in the response should be expanded. |
expires_at | integer | The Epoch time in seconds at which the Checkout Session will expire. It can be… |
integration_identifier | string | The integration identifier for this Checkout Session. Multiple Checkout… |
invoice_creation | object | Generate a post-purchase Invoice for one-time payments. |
line_items | array | A list of items the customer is purchasing. Use this parameter to pass… |
locale | string | The IETF language tag of the locale Checkout is displayed in. If blank or… |
managed_payments | object | Settings for Managed Payments for this Checkout Session and resulting… |
metadata | object | Set of key-value pairs that you can attach to an object. This can be useful… |
mode | payment | setup | subscription | The mode of the Checkout Session. Pass subscription if the Checkout Session… |
name_collection | object | Controls name collection settings for the session. You can configure Checkout… |
optional_items | array | A list of optional items the customer can add to their order at checkout. Use… |
origin_context | mobile_app | web | Where the user is coming from. This informs the optimizations that are applied… |
payment_intent_data | object | A subset of parameters to be passed to PaymentIntent creation for Checkout… |
payment_method_collection | always | if_required | Specify whether Checkout should collect a payment method. When set to… |
payment_method_configuration | string | The ID of the payment method configuration to use with this Checkout session. |
payment_method_data | object | This parameter allows you to set some attributes on the payment method created… |
payment_method_options | object | Payment-method-specific configuration. |
permissions | object | This property is used to set up permissions for various actions (for example… |
phone_number_collection | object | Controls phone number collection settings for the session. We recommend that… |
redirect_on_completion | always | if_required | never | This parameter applies to ui_mode: embedded_page. Learn more about the… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "stripe_api__post_checkout_sessions",
"arguments": {}
}Or connect the Stripe API server directly, which lists 606 tools including this one:
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the create a checkout session tool with adaptive_pricing set to ….