---
title: "Create Stripe Object"
method: POST
path: "/api/basket/stripe_object"
tags: ["Basket"]
---

# Create Stripe Object

`POST /api/basket/stripe_object`

## Request

- Base URL: `https://tickitto.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://tickitto.tech/api/basket/stripe_object`
- Auth: API key in header `key`

When using Tickitto as the Merchant of Record, creates and returns an object containing the Stripe intent needed for the front-end to handle basket payment.

**Note:* the account associated with the provided key must first be enabled for Stripe checkout before this request can succeed.

## Query parameters

- `basket_id` string, required

## Headers

- `X-Correlation-ID` string

## Request body

- Customer
  - `first_name` string, required: Customer's first name
  - `last_name` string, required: Customer's surname/family name
  - `phone_number` string, required: Customer's phone number in E.164 format
  - `email` string, email, required: Customer's email; must be a valid email
  - `currency` string: Customer's chosen currency
  - `billing_details` BillingDetails
    - `first_name` string
    - `last_name` string
    - `address` BillingAddress
      - `city` string
      - `country` string
      - `line1` string
      - `line2` string
      - `postal_code` string
      - `state` string
  - `agent_pin` string: Agent identifier, currently only used for Intele
  - `ip_location` string: IP location of the customer

## Response `200`

Successful Response

- StripeObject
  - `stripe_payment_intent` string, required
  - `stripe_payment_intent_secret` string, required
  - `customer` Customer, required
    - `first_name` string, required: Customer's first name
    - `last_name` string, required: Customer's surname/family name
    - `phone_number` string, required: Customer's phone number in E.164 format
    - `email` string, email, required: Customer's email; must be a valid email
    - `currency` string: Customer's chosen currency
    - `billing_details` BillingDetails
      - `first_name` string
      - `last_name` string
      - `address` BillingAddress
        - `city` string
        - `country` string
        - `line1` string
        - `line2` string
        - `postal_code` string
        - `state` string
    - `agent_pin` string: Agent identifier, currently only used for Intele
    - `ip_location` string: IP location of the customer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: Not Found
- `409`: Conflict
- `410`: Gone
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/tickitto/apis/tickitto-api.md) - [All operations](https://skmtc.dev/tickitto/apis/tickitto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tickitto/apis/tickitto-api/revisions/22e674e2f052?raw)