Funding Details

The Funding Details endpoint allows you to retrieve transaction-level insights for a specific virtual account session. Itโ€™s ideal for:

  • ๐Ÿ“Š Monitoring deposits
  • ๐Ÿ”„ Automating reconciliation
  • ๐Ÿ’ผ Managing cash flow

Get detailed information such as the transaction amount, sender details, time of funding, and status.


๐Ÿ” Endpoint Overview

  • Base URL:https://payment-api-service.transactpay.ai

  • Endpoint:

    GET /payment/transaction-details/{sessionId}
  • Method:GET


๐Ÿ” Required Headers

HeaderTypeRequiredDescription
api-keystringโœ… YesYour Transactpay secret API key
โš ๏ธ

A valid api-key must be provided.

Unauthorized requests will return a 401 error.


๐Ÿ“ฅ Path Parameter

ParameterTypeRequiredDescription
sessionIdstringโœ… YesUnique identifier for the transaction session

๐Ÿงพ Sample Success Response

{
    "message": "Funding Details Successfully retrieved",
    "code": null,
    "status": true,
    "data": {
        "statusCode": "00",
        "status": "Successful",
        "orderReference": null,
        "paymentReference": "ACCTBT9390A69E-2E34-4E1A-9BB7-55D2C7AD71CB",
        "productName": null,
        "totalAmountCharged": 98000.000000,
        "statusId": 5,
        "paymentMethod": null,
        "paymentResponseCode": null,
        "paymentResponseMessage": null,
        "narration": null,
        "remarks": null,
        "currencyId": 1,
        "currencyName": "NGN",
        "fee": null,
        "feeRate": null,
        "subsidiaryFee": null,
        "customerFee": null,
        "dateCreated": "2025-09-01T08:56:32.7547335",
        "dateUpdated": "2025-09-01T08:56:32.8828864",
        "datePaymentConfirmed": "2025-09-01T08:56:32.7547335",
        "sessionId": "000000250825094938139696685212",
        "sourceAccountName": "Test User",
        "sourceAccountNumber": null,
        "orderPayments": [
            {
                "orderId": 0,
                "orderPaymentReference": null,
                "paymentOptionId": 0,
                "paymentOption": null,
                "statusId": 0,
                "paymentStatus": null,
                "responseCode": null,
                "responseMessage": null,
                "orderPaymentInstrument": "01234567890",
                "remarks": null,
                "dateCreated": "2025-09-01T08:56:50",
                "dateUpdated": null
            }
        ],
        "customer": null,
        "cardDetails": null,
        "paymentLink": null,
        "bank": "OPAY DIGITAL SERVICES LIMITED",
        "accountReference": null
    }
}

โœ… Use Cases

  • โš™๏ธ Automate Workflows: Trigger internal logic when a virtual account is funded.
  • ๐Ÿ“ˆ Track Inflows: Feed data into dashboards or financial tools.
  • ๐Ÿงฎ Reconcile Payments: Match inflows with expected references or invoice IDs.