curl -X GET "https://staging-api.loyalty.lt/lt/shop/transactions?per_page=20" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 20,
    "total": 195
  },
  "data": [
    {
      "id": 1234,
      "type": "purchase",
      "points": 150,
      "amount": 49.99,
      "currency": "EUR",
      "description": "Pirkimas #WC-12345",
      "reference_number": "WC-12345",
      "status": "completed",
      "user": {
        "id": 123,
        "name": "Jonas Jonaitis",
        "email": "[email protected]",
        "phone": "+37060000000"
      },
      "loyalty_card": {
        "id": 567,
        "name": "Coffee Paradise kortelė",
        "number": "123-456-789"
      },
      "shop": {
        "id": 12,
        "name": "Coffee Paradise - Vilnius"
      },
      "metadata": {
        "source": "woocommerce",
        "points_awarded": 150,
        "items_count": 3
      },
      "transaction_date": "2024-12-08T14:30:00.000Z",
      "created_at": "2024-12-08T14:30:00.000Z"
    },
    {
      "id": 1235,
      "type": "refund",
      "points": -50,
      "amount": 0,
      "currency": "EUR",
      "description": "Grąžinimas - prekė grąžinta",
      "reference_number": "REFUND-ABC123",
      "status": "completed",
      "user": {
        "id": 124,
        "name": "Petras Petraitis",
        "email": "[email protected]",
        "phone": "+37060000001"
      },
      "loyalty_card": {
        "id": 568,
        "name": "Coffee Paradise kortelė",
        "number": "234-567-890"
      },
      "shop": null,
      "metadata": {
        "source": "woocommerce_refund",
        "points_deducted": 50,
        "reason": "Prekė grąžinta"
      },
      "transaction_date": "2024-12-08T10:15:00.000Z",
      "created_at": "2024-12-08T10:15:00.000Z"
    }
  ]
}

GET

{locale}

shop

transactions

curl -X GET "https://staging-api.loyalty.lt/lt/shop/transactions?per_page=20" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 20,
    "total": 195
  },
  "data": [
    {
      "id": 1234,
      "type": "purchase",
      "points": 150,
      "amount": 49.99,
      "currency": "EUR",
      "description": "Pirkimas #WC-12345",
      "reference_number": "WC-12345",
      "status": "completed",
      "user": {
        "id": 123,
        "name": "Jonas Jonaitis",
        "email": "[email protected]",
        "phone": "+37060000000"
      },
      "loyalty_card": {
        "id": 567,
        "name": "Coffee Paradise kortelė",
        "number": "123-456-789"
      },
      "shop": {
        "id": 12,
        "name": "Coffee Paradise - Vilnius"
      },
      "metadata": {
        "source": "woocommerce",
        "points_awarded": 150,
        "items_count": 3
      },
      "transaction_date": "2024-12-08T14:30:00.000Z",
      "created_at": "2024-12-08T14:30:00.000Z"
    },
    {
      "id": 1235,
      "type": "refund",
      "points": -50,
      "amount": 0,
      "currency": "EUR",
      "description": "Grąžinimas - prekė grąžinta",
      "reference_number": "REFUND-ABC123",
      "status": "completed",
      "user": {
        "id": 124,
        "name": "Petras Petraitis",
        "email": "[email protected]",
        "phone": "+37060000001"
      },
      "loyalty_card": {
        "id": 568,
        "name": "Coffee Paradise kortelė",
        "number": "234-567-890"
      },
      "shop": null,
      "metadata": {
        "source": "woocommerce_refund",
        "points_deducted": 50,
        "reason": "Prekė grąžinta"
      },
      "transaction_date": "2024-12-08T10:15:00.000Z",
      "created_at": "2024-12-08T10:15:00.000Z"
    }
  ]
}

List Transactions

Get paginated transaction history for all customers of the authenticated partner. Filter by user, date range, or transaction type.

This endpoint requires Shop API authentication using X-API-Key and X-API-Secret headers.

Path Parameters

locale

string

required

Language code (e.g., en, lt)

Authentication

X-API-Key

string

required

API key from Partners Portal

X-API-Secret

string

required

API secret from Partners Portal

Query Parameters

user_id

integer

Filter by user ID

user_email

string

Filter by user email address

loyalty_card_id

integer

Filter by specific loyalty card ID

shop_id

integer

Filter by shop/location ID

staff_id

integer

Filter by staff member ID who created the transaction

category_id

integer

Filter by transaction category ID

reference_number

string

Filter by exact order/reference number (e.g., WC-12345)

type

string

Filter by transaction typeValues: purchase, refund, bonus

date_from

string

Filter transactions from this date (YYYY-MM-DD)

date_to

string

Filter transactions until this date (YYYY-MM-DD)

per_page

integer

default:"15"

Number of items per page (max: 100)

page

integer

default:"1"

Page number

Response

success

boolean

Indicates if request was successful

code

integer

HTTP status code

request_id

string

Unique request identifier (UUID)

meta

object

Show meta

current_page

integer

Current page number

last_page

integer

Total number of pages

per_page

integer

Items per page

total

integer

Total number of transactions

data

array

Show Transaction Object

integer

Transaction ID

type

string

Transaction type: purchase, refund, bonus

points

integer

Points earned (positive) or deducted (negative)

amount

number

Transaction amount

currency

string

Currency code (e.g., EUR)

description

string

Transaction description

reference_number

string

Order/reference number

status

string

Transaction status: completed, pending, cancelled

user

object

Customer details (id, name, email, phone)

loyalty_card

object

Loyalty card details

shop

object

Shop details (if applicable)

transaction_date

string

ISO 8601 timestamp

curl -X GET "https://staging-api.loyalty.lt/lt/shop/transactions?per_page=20" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 20,
    "total": 195
  },
  "data": [
    {
      "id": 1234,
      "type": "purchase",
      "points": 150,
      "amount": 49.99,
      "currency": "EUR",
      "description": "Pirkimas #WC-12345",
      "reference_number": "WC-12345",
      "status": "completed",
      "user": {
        "id": 123,
        "name": "Jonas Jonaitis",
        "email": "[email protected]",
        "phone": "+37060000000"
      },
      "loyalty_card": {
        "id": 567,
        "name": "Coffee Paradise kortelė",
        "number": "123-456-789"
      },
      "shop": {
        "id": 12,
        "name": "Coffee Paradise - Vilnius"
      },
      "metadata": {
        "source": "woocommerce",
        "points_awarded": 150,
        "items_count": 3
      },
      "transaction_date": "2024-12-08T14:30:00.000Z",
      "created_at": "2024-12-08T14:30:00.000Z"
    },
    {
      "id": 1235,
      "type": "refund",
      "points": -50,
      "amount": 0,
      "currency": "EUR",
      "description": "Grąžinimas - prekė grąžinta",
      "reference_number": "REFUND-ABC123",
      "status": "completed",
      "user": {
        "id": 124,
        "name": "Petras Petraitis",
        "email": "[email protected]",
        "phone": "+37060000001"
      },
      "loyalty_card": {
        "id": 568,
        "name": "Coffee Paradise kortelė",
        "number": "234-567-890"
      },
      "shop": null,
      "metadata": {
        "source": "woocommerce_refund",
        "points_deducted": 50,
        "reason": "Prekė grąžinta"
      },
      "transaction_date": "2024-12-08T10:15:00.000Z",
      "created_at": "2024-12-08T10:15:00.000Z"
    }
  ]
}

Transaction Types

Type	Description
`purchase`	Points earned from a purchase
`refund`	Points deducted due to refund
`bonus`	Bonus points (signup, promotion)

Use Cases

WooCommerce Integration

Track all orders processed through your WooCommerce plugin:

GET /lt/shop/transactions?type=purchase&date_from=2024-12-01

Customer Lookup

View transaction history for a specific customer:

GET /lt/shop/[email protected]

Refund Tracking

Monitor all refunds and point deductions:

GET /lt/shop/transactions?type=refund

Shop/Location Transactions

View transactions for specific shop location:

GET /lt/shop/transactions?shop_id=12

Combined Filters

Filter by shop, card and date:

GET /lt/shop/transactions?shop_id=12&loyalty_card_id=567&date_from=2024-12-01

Find by Order Number

Find specific transaction by reference number:

GET /lt/shop/transactions?reference_number=WC-12345

Staff Performance

View transactions by specific staff member:

GET /lt/shop/transactions?staff_id=10&date_from=2024-12-01

Create Transaction

Create purchase and award points

Deduct Points

Deduct points for refunds

Get Loyalty Card Info

Check customer’s card and balance

Create Transaction List User Transactions

⌘I

Overview

Shop API

Authentication

Real-time (Ably)

Shops

Loyalty Cards

Transactions

Offers

Games

Coupons

Categories

Products

XML Import

List Transactions

List Transactions

Path Parameters

Authentication

Query Parameters

Response

Transaction Types

Use Cases

WooCommerce Integration

Customer Lookup

Refund Tracking

Shop/Location Transactions

Combined Filters

Find by Order Number

Staff Performance

Create Transaction

Deduct Points

Get Loyalty Card Info

Overview

Shop API

Authentication

Real-time (Ably)

Shops

Loyalty Cards

Transactions

Offers

Games

Coupons

Categories

Products

XML Import

​List Transactions

​Path Parameters

​Authentication

​Query Parameters

​Response

​Transaction Types

​Use Cases

​WooCommerce Integration

​Customer Lookup

​Refund Tracking

​Shop/Location Transactions

​Combined Filters

​Find by Order Number

​Staff Performance

​Related Endpoints

Create Transaction

Deduct Points

Get Loyalty Card Info

List Transactions

Path Parameters

Authentication

Query Parameters

Response

Transaction Types

Use Cases

WooCommerce Integration

Customer Lookup

Refund Tracking

Shop/Location Transactions

Combined Filters

Find by Order Number

Staff Performance

Related Endpoints