Create Subscription Checkout

POST

/api/stripe/subscription-checkout

Create a Stripe checkout session for subscription

This endpoint creates a Stripe-hosted checkout page for recurring subscriptions.
After payment, Stripe redirects to success_url or cancel_url.

Args:
request: Subscription checkout parameters (price_id, product_id, URLs)
current_user: Authenticated user from token

Returns:
Checkout session with URL and session ID

Example request body:
{
"price_id": "price_1SNk2KLVT8n4vaEn7lHNPYWB",
"product_id": "prod_TKOqQPhVRxNp4Q",
"customer_email": "user@example.com",
"success_url": "https://beta.gatewayz.ai/settings/credits?session_id={{CHECKOUT_SESSION_ID}}",
"cancel_url": "https://beta.gatewayz.ai/settings/credits",
"mode": "subscription"
}

Example response:
{
"session_id": "cs_test_xxxxx",
"url": "https://checkout.stripe.com/pay/cs_test_xxxxx",
"customer_id": "cus_xxxxx",
"status": "open"
}

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/stripe/subscription-checkout' \
--header 'Content-Type: application/json' \
--data-raw '{
    "price_id": "string",
    "product_id": "string",
    "customer_email": "string",
    "success_url": "string",
    "cancel_url": "string",
    "mode": "subscription",
    "metadata": {}
}'

Response Example

200 - Example 1

{}

Modified at 2025-11-07 03:16:46

Get Payment Details

Chat Completions