Reconcile payment transactions

Transaction endpoints return payment orders from the API key environment. Monetary fields include formatted and minor-unit values.

GEThttps://lirpay.org/api/v2/integration/transactions

List payment transactions.

API key or OAuth tokenpayments:read

Parameter	Type	In	Required	Description
project_id	uuid	query	no	Filter by project.
sort_by	string	query	no	created_at, status, amount, usd, or chain.
sort_dir	string	query	no	ASC or DESC.
page	integer	query	no	Page number. Defaults to 1.
limit	integer	query	no	Items per page. Maximum 100.

GEThttps://lirpay.org/api/v2/integration/transactions/{id}

Read one payment transaction with chain and customer details.

API key or OAuth tokenpayments:read

Parameter	Type	In	Required	Description
id	string	path	yes	Financial operation ID, for example LIR89924A8DCE6E. Use the id returned by the API.

Response

{
  "transaction": {
    "id": "LIR84C4E149A051",
    "status": "credited",
    "state": "succeeded",
    "chain": "tron",
    "asset_symbol": "USDT",
    "expected_amount_minor": 12900,
    "expected_amount": "129.00",
    "decimals": 2,
    "source_txid": "f7d4c38a6d749153"
  }
}

POSThttps://lirpay.org/api/v2/integration/transactions/{id}/refund

Refund a succeeded Telegram Stars payment in full.

API key or OAuth tokenpayments:writeIdempotency-Key required

Parameter	Type	In	Required	Description
id	string	path	yes	Financial operation ID, for example LIR89924A8DCE6E. Use the id returned by the API.
Idempotency-Key	string	header	yes	Unique key for this monetary operation. Maximum 255 characters.
reason	string	body	no	Optional merchant note stored on the refund.

Only telegram:XTR orders in credited, paid, or test_paid can be refunded. The buyer receives every Star back. LirPay debits the credited settlement amount; the platform fee is not returned. TEST mode skips Telegram.