List payments
Lists payment requests for the merchant. Supports pagination and filtering.
curl --request GET \
--url https://api.lite.sa/payments \
--header 'x-api-key: <api-key>'import requests
url = "https://api.lite.sa/payments"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.lite.sa/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.lite.sa/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lite.sa/payments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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;
}{
"data": [
{
"id": "baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5",
"merchant_id": "f3baf375-1cac-4aa2-bd36-0d7ca49ef59b",
"amount": 10000,
"currency": "SAR",
"status": "PENDING",
"created_at": "2026-04-08T20:53:45.517Z",
"acting_business_account_id": "6c1a1b0e-4a7e-4d51-9a6f-2f5d3f9c1a44",
"terminal_id": "0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11",
"splits": [
{
"amount": 9000,
"business_account_id": "019859f8-3149-7a55-8211-a8179675d269",
"account_reference": "main"
}
],
"processing_type": "REGULAR",
"capture_mode": "MANUAL",
"payment_instrument_id": "baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5",
"payment_method": "CARD",
"risk": {
"data": {
"enabled": true,
"device_session_id": "sess_abc123"
},
"result": {
"score": 75
}
},
"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"
},
"device": {
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
"accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9",
"language": "en-US",
"screen_height": 1080,
"screen_width": 1920,
"color_depth": 24,
"timezone": -180,
"java_enabled": false,
"java_script_enabled": true,
"ip": "192.168.1.100",
"device_data": {},
"device_fingerprint": "fp_123",
"ip_country": "SA",
"ip_city": "Riyadh",
"ip_region": "Riyadh Region",
"ip_postal_code": "12213",
"ip_latitude": 24.7136,
"ip_longitude": 46.6753,
"terminal_id": "1234567890123456"
},
"threeds": {
"data": {
"authentication_value": "<string>",
"eci": "<string>",
"version": "<string>",
"ds_transaction_id": "<string>",
"trans_status": "<string>",
"xid": "<string>"
},
"result": {
"authentication_status": "Y",
"challenge_required": true,
"eci": "05",
"authentication_value": "<string>",
"xid": "<string>",
"version": "<string>",
"ds_trans_id": "550e8400-e29b-41d4-a716-446655440000",
"acs_trans_id": "<string>"
},
"attempts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"eci": "05",
"trans_status": "Y"
}
]
},
"return_info": {
"success": "https://example.com/success",
"cancel": "https://example.com/cancel",
"error": "https://example.com/error"
},
"metadata": {},
"instrument": {
"id": "<string>",
"type": "<string>",
"last_four_digits": "1111",
"brand": "mada",
"expiry_month": 12,
"expiry_year": 27,
"cardholder_name": "<string>",
"fingerprint": "<string>",
"future_usage": "unscheduled_card_on_file",
"agreement_id": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"operations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operation_type": "CAPTURE",
"status": "SUCCESS",
"amount": 10000,
"currency": "SAR",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"idempotency_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"initiated_by": "<string>",
"acting_business_account_id": "6c1a1b0e-4a7e-4d51-9a6f-2f5d3f9c1a44",
"connector_type": "<string>",
"connector_response_code": "<string>",
"connector_response_message": "<string>",
"connector_transaction_id": "<string>",
"http_status_code": 123,
"processing_duration_ms": 123,
"retry_count": 123,
"max_retries": 123,
"next_retry_at": "2023-11-07T05:31:56Z"
}
]
}
],
"pagination_data": {
"count": 42,
"pages": 3,
"page": 1,
"page_size": 20,
"has_next": true,
"has_previous": false
}
}{
"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"
}
}{
"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"
}
}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.
"550e8400-e29b-41d4-a716-446655440000"
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.
"550e8400-e29b-41d4-a716-446655440000"
Query Parameters
Page number
x >= 1Number of items per page
1 <= x <= 100Comma-separated list of related resources to include
instrument, operations Filter by payment status Payment has been created and queued for processing
"CREATED"Start date filter (ISO 8601)
End date filter (ISO 8601)
Filter by payment method Credit or debit card payment
"CARD"curl --request GET \
--url https://api.lite.sa/payments \
--header 'x-api-key: <api-key>'import requests
url = "https://api.lite.sa/payments"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.lite.sa/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.lite.sa/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lite.sa/payments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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;
}{
"data": [
{
"id": "baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5",
"merchant_id": "f3baf375-1cac-4aa2-bd36-0d7ca49ef59b",
"amount": 10000,
"currency": "SAR",
"status": "PENDING",
"created_at": "2026-04-08T20:53:45.517Z",
"acting_business_account_id": "6c1a1b0e-4a7e-4d51-9a6f-2f5d3f9c1a44",
"terminal_id": "0b9d1c3e-6a51-4f6e-9a54-0f4f2b6e7d11",
"splits": [
{
"amount": 9000,
"business_account_id": "019859f8-3149-7a55-8211-a8179675d269",
"account_reference": "main"
}
],
"processing_type": "REGULAR",
"capture_mode": "MANUAL",
"payment_instrument_id": "baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5",
"payment_method": "CARD",
"risk": {
"data": {
"enabled": true,
"device_session_id": "sess_abc123"
},
"result": {
"score": 75
}
},
"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"
},
"device": {
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
"accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9",
"language": "en-US",
"screen_height": 1080,
"screen_width": 1920,
"color_depth": 24,
"timezone": -180,
"java_enabled": false,
"java_script_enabled": true,
"ip": "192.168.1.100",
"device_data": {},
"device_fingerprint": "fp_123",
"ip_country": "SA",
"ip_city": "Riyadh",
"ip_region": "Riyadh Region",
"ip_postal_code": "12213",
"ip_latitude": 24.7136,
"ip_longitude": 46.6753,
"terminal_id": "1234567890123456"
},
"threeds": {
"data": {
"authentication_value": "<string>",
"eci": "<string>",
"version": "<string>",
"ds_transaction_id": "<string>",
"trans_status": "<string>",
"xid": "<string>"
},
"result": {
"authentication_status": "Y",
"challenge_required": true,
"eci": "05",
"authentication_value": "<string>",
"xid": "<string>",
"version": "<string>",
"ds_trans_id": "550e8400-e29b-41d4-a716-446655440000",
"acs_trans_id": "<string>"
},
"attempts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"eci": "05",
"trans_status": "Y"
}
]
},
"return_info": {
"success": "https://example.com/success",
"cancel": "https://example.com/cancel",
"error": "https://example.com/error"
},
"metadata": {},
"instrument": {
"id": "<string>",
"type": "<string>",
"last_four_digits": "1111",
"brand": "mada",
"expiry_month": 12,
"expiry_year": 27,
"cardholder_name": "<string>",
"fingerprint": "<string>",
"future_usage": "unscheduled_card_on_file",
"agreement_id": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"operations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operation_type": "CAPTURE",
"status": "SUCCESS",
"amount": 10000,
"currency": "SAR",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"idempotency_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"initiated_by": "<string>",
"acting_business_account_id": "6c1a1b0e-4a7e-4d51-9a6f-2f5d3f9c1a44",
"connector_type": "<string>",
"connector_response_code": "<string>",
"connector_response_message": "<string>",
"connector_transaction_id": "<string>",
"http_status_code": 123,
"processing_duration_ms": 123,
"retry_count": 123,
"max_retries": 123,
"next_retry_at": "2023-11-07T05:31:56Z"
}
]
}
],
"pagination_data": {
"count": 42,
"pages": 3,
"page": 1,
"page_size": 20,
"has_next": true,
"has_previous": false
}
}{
"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"
}
}{
"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"
}
}