---
title: "Activate Session"
method: POST
path: "/api/v1/embedded/session/activate"
tags: ["Embedded Checkout"]
---

# Activate Session

`POST /api/v1/embedded/session/activate`

Activate a session and bind it to the current browser tab. Returns browser_token. Subsequent calls are rejected.

## Request body

- EmbeddedActivateRequest
  - `session_id` string, required — Session identifier to activate

## Response `200`

Successful Response

- EmbeddedActivateResponse
  - `status` integer, required — Response code, 0 means success
  - `message` string, required — Response message
  - `browser_token` string — Browser token for single-tab binding
  - `session_id` string — Session identifier
  - `amount` integer — Amount in minor units
  - `currency` string — ISO currency code
  - `language` string — Language code
  - `customer` object — Customer information
  - `basket_items` object[] — Original basket items
  - `customer_basket` object[] — Gateway payment customer basket
  - `submerchant_external_id` string — Primary submerchant external identifier
  - `is_submerchant_payment` boolean — Whether payment should be routed as submerchant
  - `campaign_name` string — Campaign name for payment request
  - `billing_tax_office` string — Billing tax office
  - `billing_tax_number` string — Billing tax number
  - `success_url` string — Merchant success callback URL
  - `fail_url` string — Merchant fail callback URL
  - `payment_methods` EmbeddedPaymentMethod[] — Available payment methods
    - `id` integer — Payment method ID
    - `name` string — Payment method name
    - `payment_type` string — Payment type code
    - `description` string — Payment method description
    - `logo_url` string — Logo image URL
    - `show_card_logos` boolean — Whether to display card brand logos
    - `is_sponsored` boolean — Whether this method is sponsored
    - `is_active` boolean — Whether this method is active
    - `sequence` integer — Display order
  - `merchant_name` string — Name of the merchant
  - `merchant_config` EmbeddedMerchantConfig
    - `application_key` string — Jetcheckout application key
    - `api_base_url` string — Merchant API base URL
    - `mode` string — Merchant mode: test or production
  - `checkout_options` EmbeddedCheckoutOptions
    - `checkout_design` string — Checkout design: simple or full
    - `show_steps` boolean — Show steps navigation
    - `show_save_card` boolean — Show save card section
    - `show_installments` boolean — Show installment options
    - `show_payment_summary` boolean — Show payment summary panel
    - `show_agreements` boolean — Show agreement checkboxes
    - `agreement_distance_sales` string — Distance sales agreement HTML content
    - `agreement_pre_information` string — Pre-information form HTML content
    - `show_cancel_order` boolean — Show cancel order button on completed page
    - `show_refund_order` boolean — Show refund order button on completed page
    - `point_usage_active` boolean — Whether point usage is active for this merchant

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/jetcheckout/apis/jet-checkout.md) · [All operations](https://skmtc.dev/jetcheckout/apis/jet-checkout/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jetcheckout/jet-checkout/revisions/b17a3806ccb0/schema)