---
title: "Create a hosted Stripe Checkout session"
method: POST
path: "/payments/stripe/create-checkout-session"
tags: ["Payments"]
---

# Create a hosted Stripe Checkout session

`POST /payments/stripe/create-checkout-session`

## Request

- Base URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api`
- URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api/payments/stripe/create-checkout-session`
- Auth: HTTP bearer

Create a Stripe Checkout session for a single payment. A pending transaction record is created and reconciled after webhook confirmation.

**For AI agents**: Use when users need a full checkout experience with Stripe-hosted payment pages.

## Request body

- object
  - `amount` number, float, required: Charge amount in the selected currency.
  - `currency` string: Three-letter ISO currency code.
  - `appId` string, required: Application identifier associated with the payment.
  - `description` string: Optional line item description shown on the checkout page.
  - `recaptchaToken` string, required: Google reCAPTCHA v3 token.

## Response `200`

Checkout session created

- object
  - `sessionId` string
  - `url` string, uri
  - `transactionId` string

## Other responses

- `400`: reCAPTCHA verification failed
- `401`: Missing or invalid authentication token
- `404`: User not found
- `429`: Rate limit exceeded
- `500`: Failed to create checkout session

---

[API](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api.md) · [All operations](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/revisions/53e075911af9?raw)