Skip to main content
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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.loyalty.lt/llms.txt

Use this file to discover all available pages before exploring further.

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
data
array
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

TypeDescription
purchasePoints earned from a purchase
refundPoints deducted due to refund
bonusBonus 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