Get Transaction by Reference

Service to retrieve detailed information about a specific transaction using the account number (IBAN) and the Account Servicer Reference.

This service is currently available only in the sandbox environment. Production availability will be announced at a later date.

Service Description

This service provides a way to check the status or details of a payment without fetching a full account statement. It is synchronous and optimized for recent transactions (within the last 14 days). The service is available only for payments processed in LHV Bank UK.

When to Use:

  • To track the status of a payment without requesting an account statement.

  • As a fallback when credit/debit notifications are unavailable.

  • For reconciliation, debugging, or investigation purposes.

Request

GET https://connect.lhv.com/accounts/{accountNumber}/transactions/{accountServicerReference}

Path Parameters

Name
Description

accountNumber

The IBAN of the account held with LHV Bank.

Use the master account, virtual IBANs (VIBANs) and indirect scheme participant accounts are not supported.

accountServicerReference

The unique payment ID assigned by LHV Bank. This reference is included in the payment status report message (pain.002), account statement (camt.053), and credit/debit notification (camt.054).

Example: 80FA866CFC3F482CB74EFE0A047DA86D. The value can be provided with or without hyphens.

Headers

Applicable for service providers and service provider users.

Name
Description

Client-Code

customer value

Client-Country

customer value

Body

This request doesn't have a body.

Response

Successful Response

If the payment is found, the response includes full payment details such as status, amount, counterparties, and payment description.

  • For debit transactions, receiver (creditor) details are included.

  • For credit transactions, sender (debtor) details are included.

  • For virtual account (VIBAN) payments, if either the sender or receiver was a VIBAN, the field IsVirtualAccountPayment: true is returned and the related virtual account details are added to the response.

No Transaction Found

If the transaction cannot be found, a 404 response is returned.

This may happen if:

  • payment has not yet been processed (no reservation exists),

    • payment has been cancelled

  • the account servicer reference is invalid, or

  • the payment is older than the 14-day lookup window.

Payment Status

Statuses in the response are simplified for clarity:

  • Pending – The payment is being processed but has not yet been booked on the account.

  • Booked – The payment has been fully processed and the account has been debited or credited.

Examples

{
  "EndToEndId" : "EndToEndId123456",
  "IsVirtualAccountPayment" : false,
  "Amount" : {
    "Amount" : "1.00",
    "Currency" : "GBP"
  },
  "CreditDebitIndicator" : "Debit",
  "Status" : "Booked",
  "BookingDateTime" : "2025-10-31",
  "ValueDateTime" : "2025-10-31",
  "CreditorAgent" : {
    "SchemeName" : "BIC",
    "Identification" : "LHVBGB2LXXX"
  },
  "CreditorAccount" : {
    "Identification" : "GB80LHVB04030700012345",
    "Name" : "Connect Demo Company"
  },
  "TransactionId" : "A5A7DFE0-C65A-4F89-AA4B-EBE944E749E7"
}
PreviousIncoming Bacs Credit NotificationNextGet List of Accounts

Last updated

Was this helpful?