Skip to main content

​
Overview

The monei.transaction service allows you to retrieve and filter user transactions, including deposits and individual transaction lookups by ID or reference. This service provides:
  • Fetch all user transactions
  • Filter transactions by type
  • Retrieve deposits only
  • Get transaction details by ID
  • Get transaction details by reference

​
Get User Transactions

Retrieve all transactions for the authenticated user. 
const transactions = await monei.transaction.getUserTransactions();

console.log(transactions.data.transactions);
console.log(transactions.data.pagination);
Endpoint 
GET /api/v1/transactions/user

​
Get Transactions by Type

Filter transactions by type using the TransactionType enum. 
import { TransactionType } from "monei-sdk";

const credits = await monei.transaction.getTransactionsByType(
  TransactionType.CREDIT
);

console.log(credits.transactions);

​
Available Types

  • TransactionType.CREDIT
  • TransactionType.DEBIT

​
Get Deposits

Retrieve only deposit (credit) transactions. 
const deposits = await monei.transaction.getDeposits();

console.log(deposits.transactions);
This is equivalent to filtering by: 
TransactionType.CREDIT

​
Get Single Deposit

Retrieve a single deposit by ID or Reference.

​
By ID

const deposit = await monei.transaction.getDeposit({
  id: "txn_123456"
});

console.log(deposit.amount, deposit.status);

​
By Reference

const deposit = await monei.transaction.getDeposit({
  reference: "ref_ABC123"
});

console.log(deposit.amount, deposit.status);

​
Get Transaction by ID

const transaction = await monei.transaction.getTransactionById("txn_123456");

console.log(transaction);
Endpoint 
GET /api/v1/transactions/{id}

​
Get Transaction by Reference

const transaction = await monei.transaction.getTransactionByReference("ref_ABC123");

console.log(transaction);
Endpoint 
GET /api/v1/transactions/reference/{reference}

​
Response Structure

​
UserTransactionsResponseDto

{
  data: {
    transactions: TransactionDto[],
    pagination: {
      total: number,
      page: number,
      limit: number
    }
  }
}

​
TransactionDto

{
  id: string,
  reference: string,
  type: "CREDIT" | "DEBIT",
  amount: number,
  currency: string,
  status: string,
  createdAt: string
}

​
Error Handling

All transaction service calls may throw an error if the request fails. 
try {
  const transactions = await monei.transaction.getUserTransactions();
} catch (error) {
  console.error(error.message);
}

​
Service Overview

MethodDescription
getUserTransactions()Retrieve all user transactions
getTransactionsByType(type)Filter transactions by type
getDeposits()Retrieve credit transactions only
getDeposit(\{ id | reference \})Retrieve a single deposit
getTransactionById(id)Retrieve transaction by ID
getTransactionByReference(reference)Retrieve transaction by reference