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": "[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
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": "[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

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/[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