---
title: "Create In-store QR Code Checkout Session"
method: POST
path: "/checkout/in-store"
tags: ["In-Store Checkout"]
---

# Create In-store QR Code Checkout Session

`POST /checkout/in-store`

This endpoint facilitates the creation of an In-Store checkout link that can be converted to a QR code, enabling customer payments via Tamara customer app using the Scan to Pay function. <br /> <br /> Please store the `order_id` and `checkout_id` received in response in your DBs as they might be needed later.

## Headers

- `X-Device-Id` string, number, required

## Request body

- object
  - `amount` object, required — Total amount to be charged to consumer.
    - `amount` number
    - `currency` 'SAR' | 'AED' | 'BHD' | 'KWD' | 'OMR'
  - `order_reference_id` string — The unique order id from merchant side, this will be used with the settlement and reports
  - `order_number` string — Unique order ID from the merchant's side, which will be used for settlement and reporting purposes. Can be modified after the checkout session is created.
  - `platform` string, required
  - `locale` 'ar_SA' | 'en_US' — Display language for Tamara checkout page. Language to be defined by the merchant following RFC 1766, e.g `en_US` or `ar_SA`. Default is set to Arabic if value not passed and customer is new. If customer already exists and locale is not passed then customer's preference will be taken into account.
  - `additional_data` object — Additional order data information from the merchant side
    - `store_code` string — The unique store code/name from which request is called

## Response `200`

Checkout Session Created

- object
  - `checkout_id` string, uuid
  - `order_id` string, uuid
  - `checkout_deeplink` string

## Other responses

- `400` — Unsupported Country/Currency

---

[API](https://skmtc.net/tamara/apis/tamara-public-apis-v1-0.md) · [All operations](https://skmtc.net/tamara/apis/tamara-public-apis-v1-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tamara/tamara-public-apis-v1-0/revisions/924ade2a1159/schema)