Skip to main content
GET
/
api
/
v1
/
wallets
/
fiat
/
transactions
/
{transactionId}
Fetch Wallet Single Transaction
curl --request GET \
  --url https://api.example.com/api/v1/wallets/fiat/transactions/{transactionId} \
  --header 'x-api-key: <x-api-key>'
{
  "transactionId": "txn_abc123",
  "transactionType": "deposit",
  "walletId": "wal_xyz789",
  "accountNumber": "1234567890",
  "status": "completed",
  "amount": 50000,
  "fee": 0,
  "originator": {
    "accountNumber": "0987654321",
    "accountName": "JOHN DOE",
    "bankName": "GTBank"
  },
  "narration": "Payment from John Doe",
  "reference": "FP-20240115-001",
  "createdAt": "2024-01-15T10:30:45Z"
}

​
Path Parameters

​
transactionId
string
required
The unique identifier of the transaction

​
Request

​
x-api-key
string
required
API Key for authentication

​
Request Example

curl https://api-staging.fossapay.com/api/v1/wallets/fiat/transactions/txn_abc123 \
  -H "x-api-key: fp_live_sk_xxxxxxxx"

const response = await fetch('https://api-staging.fossapay.com/api/v1/wallets/fiat/transactions/txn_abc123', {
  headers: {
    'x-api-key': 'fp_live_sk_xxxxxxxx'
  }
});

const transaction = await response.json();

import requests

url = "https://api-staging.fossapay.com/api/v1/wallets/fiat/transactions/txn_abc123"
headers = {"x-api-key": "fp_live_sk_xxxxxxxx"}

response = requests.get(url, headers=headers)
transaction = response.json()

​
Response

​
transactionId
string
Unique transaction identifier
​
transactionType
string
Transaction type: deposit or withdrawal
​
walletId
string
Wallet ID (virtual account ID)
​
accountNumber
string
Virtual account number
​
status
string
Transaction status
​
amount
number
Transaction amount
​
fee
number
Transaction fee
​
beneficiary
object
​
originator
object
​
toWalletAccountNumber
string
Destination wallet account number (for internal transfers)
​
narration
string
Transaction narration
​
reference
string
Transaction reference
​
createdAt
string
Transaction timestamp

​
Response Example

{
  "transactionId": "txn_abc123",
  "transactionType": "deposit",
  "walletId": "wal_xyz789",
  "accountNumber": "1234567890",
  "status": "completed",
  "amount": 50000,
  "fee": 0,
  "originator": {
    "accountNumber": "0987654321",
    "accountName": "JOHN DOE",
    "bankName": "GTBank"
  },
  "narration": "Payment from John Doe",
  "reference": "FP-20240115-001",
  "createdAt": "2024-01-15T10:30:45Z"
}

​
Error Codes

CodeDescription
TRANSACTION_NOT_FOUNDTransaction with this ID does not exist
UNAUTHORIZEDInvalid API key or insufficient permissions
Store transaction details for reconciliation and audit purposes.
Use this endpoint to verify specific transactions when needed.