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": "jonas@example.com",
        "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": "petras@example.com",
        "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": "jonas@example.com",
        "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": "petras@example.com",
        "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": "jonas@example.com",
        "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": "petras@example.com",
        "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/transactions?user_email=customer@example.com

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

​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