CBL | DevPortal
  • Welcome to the Central Bank of Libya Developer Portal | DevPortal
  • LYPay
    • LYPay Instant Payment System
    • Regulatory Guidelines & Compliance
    • Accounting & Settlement in LYPay
    • LYPay Instant Payment System – Technical Overview
    • API Documentation
      • About the APIs
      • API reference
        • Webhooks
        • Auth
          • Revoke
        • Api
          • V1
            • Miscs
              • Institutions
              • Transaction status
            • Payments
              • Funds transfers
                • Refund
                • Confirm
              • Debited funds transfers
              • Credited funds transfers
                • By internal merchant reference
              • Details
            • Auth
              • Token
              • Password
                • Reset
      • Specification
    • NUMO QR Code Standards
  • Contact & Support
Powered by GitBook
On this page
  1. LYPay
  2. API Documentation
  3. API reference
  4. Api
  5. V1
  6. Payments

Details

PreviousBy internal merchant referenceNextAuth

Retrieve Transaction Details

post

Retrieves detailed transaction information based on provided parameters (RRN, paymentReference, terminalID, etc). Returns 409 if multiple results exist or 404 if no result is found.

Authorizations
Body
rrnstringRequiredExample: MANDATORY
paymentReferencestringOptionalExample: OPTIONAL
terminalIDstringOptionalExample: OPTIONAL
panstringOptionalExample: OPTIONAL
transactionDatestringOptionalExample: OPTIONAL
transactionTimestringOptionalExample: OPTIONAL
accountNumberstringOptionalExample: OPTIONAL
stanstringOptionalExample: OPTIONAL
Responses
200
Transaction details retrieved successfully
application/json
404
Not Found – No result found
application/json
409
Conflict – Multiple results found
application/json
default
An error response object
application/json
post
POST /api/v1/payments/details HTTP/1.1
Host: 127.0.0.1:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "rrn": "MANDATORY",
  "paymentReference": "OPTIONAL",
  "terminalID": "OPTIONAL",
  "pan": "OPTIONAL",
  "transactionDate": "OPTIONAL",
  "transactionTime": "OPTIONAL",
  "accountNumber": "OPTIONAL",
  "stan": "OPTIONAL"
}
{
  "rrn": "14592323325",
  "paymentReference": "3992ga-gaj32224-ajjago2-2ia2",
  "terminalID": "",
  "pan": "",
  "fromAccount": "",
  "toAccount": "",
  "amount": "100000",
  "currency": "lyd",
  "transactionDate": "25/01/2024",
  "transactionTime": "22:01:50",
  "type": "debit",
  "responseCode": "01",
  "isReversed": false,
  "reverseResponseCode": "05"
}