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 requiredpayments: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 requiredpayments:read

Parameter	Type	In	Required	Description
id	uuid	path	yes	Resource identifier returned by a list or create operation.

Response

{
  "transaction": {
    "id": "2f361e7f-7fd5-4962-82b6-b062d28ae848",
    "internal_txid": "LIRPAY84C4E149A051",
    "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 requiredpayments:writeIdempotency-Key required

Parameter	Type	In	Required	Description
id	uuid	path	yes	Resource identifier returned by a list or create operation.
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.