In Finmo, everything revolves around the concept of wallets and transaction ledgers. While collecting funds from customers, they can be deposited into the organization’s Payin wallet or the customer wallets. For Payouts, the Payout wallet needs to be funded to transfer funds either locally or cross-border.
All successful transactions (such as Payin, Payout, refund, etc.) with a status of COMPLETED will affect the balance of the wallet. These transactions will appear under Wallet Transactions.
Transactions with a status of PENDING, CANCELLED, or EXPIRED will appear in the List All Payins, List All Payouts and List all Refunds APIs.
In addition to standard CREDIT and DEBIT transaction types, there will also be RESERVE and RELEASE transaction types. These types are specific to money exiting the Finmo system, typically in cases of Refunds and Payouts. They allow Finmo to block the funds until the process is completed, ensuring the funds are not available for any other operations.
How is the Wallet Transaction API different from the Transaction Report API?
When a Payin is COMPLETED, Finmo will CREDIT the Payin wallet and DEBIT the Fees wallet. These transactions will appear as separate line items under their respective wallets. Under list all wallet transactions using the appropriate wallet_id, one will see these transactions.
However, the Transaction Report API will consolidate this information into a single line item for the Payin transaction. This line item will include details such as the total amount paid, total fees charged, total taxes charged, amount without taxes, whether the transaction was settled, and whether the transaction was reconciled.
List all Wallet transactions
Retrieve a list of all the Wallet Transactions. Use query parameters to filter the list.
This API comes with Pagination support, you can customize limit and page query parameters as per the requirements.