---
title: "Copy of Create Checkout Session"
method: PATCH
path: "/checkout/sessions/{checkout_session}"
---

# Copy of Create Checkout Session

`PATCH /checkout/sessions/{checkout_session}`

## Path parameters

- `checkout_session` string, required

## Request body

- object
  - `customer_id` string — The unique identifier of the customer, created using the [Create Customer](https://docs.y.uno/reference/create-customer) endpoint (UUID, 36 chars).
  - `merchant_order_id` string, required — The unique identifier of the customer's order (MAX 255; MIN 3).
  - `payment_description` string, required — The description of the payment (MAX 255; MIN 3).
  - `callback_url` string — The URL where we will redirect your customer after making the purchase. Required for alternative payment methods with redirection. (MAX 526; MIN 3)
  - `country` 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'CR' | 'EC' | 'SV' | 'GT' | 'HN' | 'MX' | 'NI' | 'PA' | 'PY' | 'PE' | 'US' | 'UY', required — The customer's country (MAX 2; MIN 2; [ISO 3166-1](country-reference)).
  - `account_id` string, required — The unique identifier of the account. You find this information on [the Yuno dashboard](https://dashboard.y.uno/) (UUID, 36 chars).
  - `amount` object — Specifies the payment amount object, with the value and currency.
    - `currency` string, required — The currency used to make the payment. For a full list of currency codes, see [Country reference](/reference/country-reference) (MAX 3; MIN 3; ISO 4217).
    - `value` number, float, required — The payment amount (multiple of 0.0001).
  - `alternative_amount` object — Alternative currency representation of the transaction amount.
    - `currency` string, nullable, required — The alternative currency code. For a full list of currency codes, see [Country reference](/reference/country-reference) (MAX 3; MIN 3; ISO 4217).
    - `value` number, float, required — The alternative amount value (multiple of 0.0001).
  - `metadata` object[] — Specifies a list of metadata objects. You can add up to 120 metadata objects.
    - `key` string, required — The metadata key (MAX 48)
    - `value` string, required — The metadata key value (MAX 512)
  - `workflow` 'SDK_CHECKOUT' | 'CHECKOUT' | 'SDK_SEAMLESS' — Checkout workflow type.
  - `installments` object — The object to send the installment plan created in Yuno to show your customers and let them choose from. This optional field is used in case a particular installments plan needs to be used in the session. if not sent, we will display the installment plan created for the account for each scenario, if any.
    - `plan_id` string — Plan Id of the installment plan created in Yuno
    - `plan` object[] — Installments to show the customer in with the checkout_session. This optional struct is used in case a particular installments plan needs to be used in the session and does not have an installments plan created for it. if not sent, we will display the installment plan created for the account for each scenario, if any.
      - `installment` integer, required — The number of monthly installments shoppers can choose
      - `rate` number, float, required — The rate applied to the final amount of the transaction by the payment provider after using installments. The value should be entered as a multiplier, not a percentage. For example, to apply a 20% rate, enter `1.20` instead of `20`.

## Response `200`

200

- object
  - `merchant_order_id` string
  - `checkout_session` string
  - `country` string
  - `payment_description` string
  - `callback_url` unknown
  - `amount` object
    - `currency` string
    - `value` integer
  - `created_at` string
  - `metadata` unknown
  - `workflow` string
  - `installments` object
    - `plan_id` unknown
    - `plan` unknown
  - `used` boolean

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/versions/05b629819b49/schema)