Create a checkout session
Creates a new hosted checkout session and returns a payment link and client secret for use in the frontend SDK.
POST
https://api.lite.sa
/
checkout-sessions
Create a checkout session
curl --request POST \
--url https://api.lite.sa/checkout-sessions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 10000,
"currency": "SAR",
"redirect_urls": {
"success": "https://example.com/success",
"failure": "https://example.com/failure"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": {
"amount": 750
},
"shipping": {
"amount": 1000
}
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
}
}
'import requests
url = "https://api.lite.sa/checkout-sessions"
payload = {
"amount": 10000,
"currency": "SAR",
"redirect_urls": {
"success": "https://example.com/success",
"failure": "https://example.com/failure"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": { "amount": 750 },
"shipping": { "amount": 1000 }
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10000,
currency: 'SAR',
redirect_urls: {success: 'https://example.com/success', failure: 'https://example.com/failure'},
order: {
reference: 'ORD-123456',
items: {
products: [
{
id: 'prod_123',
price: 5000,
quantity: 2,
name: 'T-Shirt',
metadata: {color: 'Blue', size: 'L'}
}
],
vat: {amount: 750},
shipping: {amount: 1000}
},
shipping_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
billing_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
amount: 10000,
currency: 'SAR',
description: 'Order description'
}
})
};
fetch('https://api.lite.sa/checkout-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10000,
currency: 'SAR',
redirect_urls: {success: 'https://example.com/success', failure: 'https://example.com/failure'},
order: {
reference: 'ORD-123456',
items: {
products: [
{
id: 'prod_123',
price: 5000,
quantity: 2,
name: 'T-Shirt',
metadata: {color: 'Blue', size: 'L'}
}
],
vat: {amount: 750},
shipping: {amount: 1000}
},
shipping_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
billing_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
amount: 10000,
currency: 'SAR',
description: 'Order description'
}
})
};
fetch('https://api.lite.sa/checkout-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lite.sa/checkout-sessions"
payload := strings.NewReader("{\n \"amount\": 10000,\n \"currency\": \"SAR\",\n \"redirect_urls\": {\n \"success\": \"https://example.com/success\",\n \"failure\": \"https://example.com/failure\"\n },\n \"order\": {\n \"reference\": \"ORD-123456\",\n \"items\": {\n \"products\": [\n {\n \"id\": \"prod_123\",\n \"price\": 5000,\n \"quantity\": 2,\n \"name\": \"T-Shirt\",\n \"metadata\": {\n \"color\": \"Blue\",\n \"size\": \"L\"\n }\n }\n ],\n \"vat\": {\n \"amount\": 750\n },\n \"shipping\": {\n \"amount\": 1000\n }\n },\n \"shipping_address\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"street\": \"123 Main St\",\n \"city\": \"Riyadh\",\n \"state\": \"Riyadh Region\",\n \"zip\": \"12213\",\n \"country\": \"SA\"\n },\n \"billing_address\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"street\": \"123 Main St\",\n \"city\": \"Riyadh\",\n \"state\": \"Riyadh Region\",\n \"zip\": \"12213\",\n \"country\": \"SA\"\n },\n \"amount\": 10000,\n \"currency\": \"SAR\",\n \"description\": \"Order description\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lite.sa/checkout-sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 10000,
'currency' => 'SAR',
'redirect_urls' => [
'success' => 'https://example.com/success',
'failure' => 'https://example.com/failure'
],
'order' => [
'reference' => 'ORD-123456',
'items' => [
'products' => [
[
'id' => 'prod_123',
'price' => 5000,
'quantity' => 2,
'name' => 'T-Shirt',
'metadata' => [
'color' => 'Blue',
'size' => 'L'
]
]
],
'vat' => [
'amount' => 750
],
'shipping' => [
'amount' => 1000
]
],
'shipping_address' => [
'name' => 'John Doe',
'email' => 'john@example.com',
'street' => '123 Main St',
'city' => 'Riyadh',
'state' => 'Riyadh Region',
'zip' => '12213',
'country' => 'SA'
],
'billing_address' => [
'name' => 'John Doe',
'email' => 'john@example.com',
'street' => '123 Main St',
'city' => 'Riyadh',
'state' => 'Riyadh Region',
'zip' => '12213',
'country' => 'SA'
],
'amount' => 10000,
'currency' => 'SAR',
'description' => 'Order description'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "550e8400-e29b-41d4-a716-446655440000",
"session_id": "550e8400-e29b-41d4-a716-446655440000",
"hosted_url": "https://checkout.lite.sa/ses_a1b2c3d4e5f6",
"client_secret": "cs_a1b2c3d4e5f6",
"status": "Pending",
"expires_on": "2026-05-18T12:00:00.000Z",
"order_id": "ORD-123456",
"amount": 10000,
"currency": "SAR",
"customer": {
"id": "cust_a1b2c3d4e5f6",
"email": "john.doe@email.com",
"first_name": "John",
"last_name": "Doe",
"phone_country_code": "+966",
"phone_number": "555123456"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": {
"amount": 750
},
"shipping": {
"amount": 1000
}
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
},
"channel_id": "550e8400-e29b-41d4-a716-446655440000",
"terminal_id": "0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11"
}{
"errors": [
{
"category": "VALIDATION",
"code": "INVALID_REQUEST",
"message": "The terminal is not active.",
"retriable": false
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"errors": [
{
"category": "VALIDATION",
"code": "ENTITY_NOT_FOUND",
"message": "The terminal was not found.",
"retriable": false
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"errors": [
{
"category": "CONNECTION",
"code": "PROVIDER_UNAVAILABLE",
"message": "The terminal could not be confirmed. Retry the request.",
"retriable": true
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Authorizations
API key for service-to-service or merchant authentication.
Headers
Unique identifier for request tracing. Generated by the client or server if not provided.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Unique key for idempotent request processing. Duplicate requests with the same key are safely ignored.
Example:
"baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5"
The business account to act on, for platform use cases. When sent, that account is the merchant for the request: resources are created under it, reads and 404 checks are scoped to it, and per-merchant uniqueness (such as merchant_reference_id) applies within it. The API key's own account is recorded as the account acting on its behalf. Omit it to act on the API key's own account.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Body
application/json
Create a new hosted checkout session
Request body for creating a new checkout session
Payment amount in minor units (e.g. 10000 for 100.00 SAR)
Required range:
x >= 1Example:
10000
Currency code (ISO 4217)
Example:
"SAR"
Redirect URLs for checkout session
Show child attributes
Show child attributes
Order details
Show child attributes
Show child attributes
Customer details for checkout session creation. When provided, id is required.
Show child attributes
Show child attributes
Session expiry in seconds (default 3600)
Required range:
60 <= x <= 86400Example:
1800
Deprecated and ignored. 3D Secure is enforced per channel; turn it on under Settings, Acceptance, Payment methods in the dashboard. Sending this field still succeeds and has no effect.
Example:
false
processing_type
Regular · stringCard on File · stringUnscheduled Card on File · stringMOTO · string
default:REGULAR
Standard one-time payment
Allowed value:
"REGULAR"Example:
"REGULAR"
Capture the payment immediately upon authorization
Allowed value:
"INSTANT"Example:
"INSTANT"
Additional metadata
Example:
{ "session_type": "standard" }
Channel ID for the session
Example:
"550e8400-e29b-41d4-a716-446655440000"
Online terminal the session's payment is taken through. Defaults to the business account's default terminal at the time the session is created; later changes to the default do not move it. Business accounts only, and not together with channel_id.
Example:
"0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11"
Optional transaction-level split allocations in minor units. The full payment lands in the main acceptance account first; each allocation is then transferred to its destination, and the remainder stays in the main account. The allocations must not total more than amount. If sent, it must contain at least one item. Payment sessions only; rejected on a tokenization session.
Minimum array length:
1Show child attributes
Show child attributes
Response
Checkout session created successfully.
Response returned after creating or updating a checkout session
Unique checkout session identifier
Example:
"550e8400-e29b-41d4-a716-446655440000"
Deprecated alias of id. Use id instead.
Example:
"550e8400-e29b-41d4-a716-446655440000"
URL for the hosted checkout page
Example:
"https://checkout.lite.sa/ses_a1b2c3d4e5f6"
Client secret for frontend SDK authentication
Example:
"cs_a1b2c3d4e5f6"
Session is active and awaiting payment
Allowed value:
"Pending"Example:
"Pending"
Session expiry timestamp
Example:
"2026-05-18T12:00:00.000Z"
Order reference
Example:
"ORD-123456"
Session amount in minor units
Example:
10000
Currency code (ISO 4217)
Example:
"SAR"
Customer details
Show child attributes
Show child attributes
Order details
Show child attributes
Show child attributes
Channel ID for the session
Example:
"550e8400-e29b-41d4-a716-446655440000"
Online terminal the session's payment is taken through. Present for business accounts only.
Example:
"0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11"
⌘I
Create a checkout session
curl --request POST \
--url https://api.lite.sa/checkout-sessions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 10000,
"currency": "SAR",
"redirect_urls": {
"success": "https://example.com/success",
"failure": "https://example.com/failure"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": {
"amount": 750
},
"shipping": {
"amount": 1000
}
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
}
}
'import requests
url = "https://api.lite.sa/checkout-sessions"
payload = {
"amount": 10000,
"currency": "SAR",
"redirect_urls": {
"success": "https://example.com/success",
"failure": "https://example.com/failure"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": { "amount": 750 },
"shipping": { "amount": 1000 }
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10000,
currency: 'SAR',
redirect_urls: {success: 'https://example.com/success', failure: 'https://example.com/failure'},
order: {
reference: 'ORD-123456',
items: {
products: [
{
id: 'prod_123',
price: 5000,
quantity: 2,
name: 'T-Shirt',
metadata: {color: 'Blue', size: 'L'}
}
],
vat: {amount: 750},
shipping: {amount: 1000}
},
shipping_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
billing_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
amount: 10000,
currency: 'SAR',
description: 'Order description'
}
})
};
fetch('https://api.lite.sa/checkout-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 10000,
currency: 'SAR',
redirect_urls: {success: 'https://example.com/success', failure: 'https://example.com/failure'},
order: {
reference: 'ORD-123456',
items: {
products: [
{
id: 'prod_123',
price: 5000,
quantity: 2,
name: 'T-Shirt',
metadata: {color: 'Blue', size: 'L'}
}
],
vat: {amount: 750},
shipping: {amount: 1000}
},
shipping_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
billing_address: {
name: 'John Doe',
email: 'john@example.com',
street: '123 Main St',
city: 'Riyadh',
state: 'Riyadh Region',
zip: '12213',
country: 'SA'
},
amount: 10000,
currency: 'SAR',
description: 'Order description'
}
})
};
fetch('https://api.lite.sa/checkout-sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lite.sa/checkout-sessions"
payload := strings.NewReader("{\n \"amount\": 10000,\n \"currency\": \"SAR\",\n \"redirect_urls\": {\n \"success\": \"https://example.com/success\",\n \"failure\": \"https://example.com/failure\"\n },\n \"order\": {\n \"reference\": \"ORD-123456\",\n \"items\": {\n \"products\": [\n {\n \"id\": \"prod_123\",\n \"price\": 5000,\n \"quantity\": 2,\n \"name\": \"T-Shirt\",\n \"metadata\": {\n \"color\": \"Blue\",\n \"size\": \"L\"\n }\n }\n ],\n \"vat\": {\n \"amount\": 750\n },\n \"shipping\": {\n \"amount\": 1000\n }\n },\n \"shipping_address\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"street\": \"123 Main St\",\n \"city\": \"Riyadh\",\n \"state\": \"Riyadh Region\",\n \"zip\": \"12213\",\n \"country\": \"SA\"\n },\n \"billing_address\": {\n \"name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"street\": \"123 Main St\",\n \"city\": \"Riyadh\",\n \"state\": \"Riyadh Region\",\n \"zip\": \"12213\",\n \"country\": \"SA\"\n },\n \"amount\": 10000,\n \"currency\": \"SAR\",\n \"description\": \"Order description\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lite.sa/checkout-sessions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 10000,
'currency' => 'SAR',
'redirect_urls' => [
'success' => 'https://example.com/success',
'failure' => 'https://example.com/failure'
],
'order' => [
'reference' => 'ORD-123456',
'items' => [
'products' => [
[
'id' => 'prod_123',
'price' => 5000,
'quantity' => 2,
'name' => 'T-Shirt',
'metadata' => [
'color' => 'Blue',
'size' => 'L'
]
]
],
'vat' => [
'amount' => 750
],
'shipping' => [
'amount' => 1000
]
],
'shipping_address' => [
'name' => 'John Doe',
'email' => 'john@example.com',
'street' => '123 Main St',
'city' => 'Riyadh',
'state' => 'Riyadh Region',
'zip' => '12213',
'country' => 'SA'
],
'billing_address' => [
'name' => 'John Doe',
'email' => 'john@example.com',
'street' => '123 Main St',
'city' => 'Riyadh',
'state' => 'Riyadh Region',
'zip' => '12213',
'country' => 'SA'
],
'amount' => 10000,
'currency' => 'SAR',
'description' => 'Order description'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "550e8400-e29b-41d4-a716-446655440000",
"session_id": "550e8400-e29b-41d4-a716-446655440000",
"hosted_url": "https://checkout.lite.sa/ses_a1b2c3d4e5f6",
"client_secret": "cs_a1b2c3d4e5f6",
"status": "Pending",
"expires_on": "2026-05-18T12:00:00.000Z",
"order_id": "ORD-123456",
"amount": 10000,
"currency": "SAR",
"customer": {
"id": "cust_a1b2c3d4e5f6",
"email": "john.doe@email.com",
"first_name": "John",
"last_name": "Doe",
"phone_country_code": "+966",
"phone_number": "555123456"
},
"order": {
"reference": "ORD-123456",
"items": {
"products": [
{
"id": "prod_123",
"price": 5000,
"quantity": 2,
"name": "T-Shirt",
"metadata": {
"color": "Blue",
"size": "L"
}
}
],
"vat": {
"amount": 750
},
"shipping": {
"amount": 1000
}
},
"shipping_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"billing_address": {
"name": "John Doe",
"email": "john@example.com",
"street": "123 Main St",
"city": "Riyadh",
"state": "Riyadh Region",
"zip": "12213",
"country": "SA"
},
"amount": 10000,
"currency": "SAR",
"description": "Order description"
},
"channel_id": "550e8400-e29b-41d4-a716-446655440000",
"terminal_id": "0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11"
}{
"errors": [
{
"category": "VALIDATION",
"code": "INVALID_REQUEST",
"message": "The terminal is not active.",
"retriable": false
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"errors": [
{
"category": "VALIDATION",
"code": "ENTITY_NOT_FOUND",
"message": "The terminal was not found.",
"retriable": false
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"error": {
"code": "PAYMENT_DETAILS_MISMATCH",
"message": "The request was invalid or malformed",
"timestamp": "2024-12-16T10:30:00.000Z",
"details": {},
"correlation_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"errors": [
{
"category": "CONNECTION",
"code": "PROVIDER_UNAVAILABLE",
"message": "The terminal could not be confirmed. Retry the request.",
"retriable": true
}
],
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}