Get Wallet Transaction Details

Retrieves the details of a specific wallet transaction using the user's reference and transaction reference. This endpoint is useful when you need to look up a particular transaction and view its amount, wallet, currency, status, balance changes, and other transaction details.

Endpoint

GET {{base_url}}/api/v1/wallet/transaction/data

Authentication

Requires your Merchant API Key.

Headers

Header	Required	Description
`X-merchant-ref`	Yes	Your unique merchant reference.

Example Request

curl --location -g '{{base_url}}/api/v1/wallet/transaction/data?user_ref={USER_REF}&reference={{transaction_reference}}' \
--header 'X-merchant-ref: {{x-merchant-ref}}'

Query Parameters

Parameter	Required	Type	Description
`user_ref`	Yes	String	Reference of the user associated with the transaction.
`txn-reference`	Yes	String	Unique reference of the transaction to retrieve.

Response

`200 OK`

{
  "status": "success",
  "message": "Retrieved successfully",
  "data": [
    {
      "amount": 0.5,
      "available_balance_after": 0,
      "available_balance_before": 0,
      "category": "COLLECTION",
      "currency": "USDT:POL",
      "date": "2026-09-08T08:05:03.986433Z",
      "description": "DYNAMIC_COLLECTION",
      "ledger_balance_after": 0,
      "ledger_balance_before": 0,
      "payment_reference": "6a733723-7724-4efc-8f57-3cd923b0e01c",
      "reference": "LIVE_0009_02_09_0162",
      "status": "PENDING",
      "type": "CREDIT",
      "wallet_id": "LBWUSDT:POL1649B6B5F7524B3C9DE3618DF461947200F2Y"
    }
  ]
}

Response Fields

Field	Type	Description
`amount`	Number	Amount involved in the transaction.
`available_balance_after`	Number	Available wallet balance after the transaction.
`available_balance_before`	Number	Available wallet balance before the transaction.
`category`	String	Transaction category, such as `COLLECTION`, `PAYOUT`, or `TRANSFER`.
`currency`	String	Currency of the transaction, such as `NGN`, `CAD`, or `USDT:POL`.
`date`	String	Date and time when the transaction was recorded.
`description`	String	Description or internal classification of the transaction.
`ledger_balance_after`	Number	Ledger balance after the transaction.
`ledger_balance_before`	Number	Ledger balance before the transaction.
`payment_reference`	String	Payment reference associated with the transaction.
`reference`	String	Unique reference identifying the transaction.
`status`	String	Current status of the transaction, such as `SUCCESSFUL` or `PENDING`.
`type`	String	Indicates whether the transaction is a `CREDIT` or `DEBIT`.
`wallet_id`	String	ID of the wallet associated with the transaction.

Updated 20 days ago

Did this page help you?