In Finmo, everything is built around the concept of wallets and its transaction ledger. If you collect funds from your consumers they can land up in your Payin wallet or their own customer wallets. For Payouts, we have a Payout wallet and you need to fund it in order to transfer funds out locally or cross-border.
All successful transactions (Payin, Payout, refund etc) i.e. whose status is COMPLETED will impact the balance of the wallet. Such transactions will appear under Wallet Transactions.
All transactions that were in PENDING, CANCELLED or EXPIRED status will appear in List All Payins, List All Payouts and List all Refunds API.
Apart from standard CREDIT and DEBIT transaction types you will also see RESERVE and RELEASE transaction types that are specific to money going out of Finmo system, typically in case of Refunds and Payouts. These types allow Finmo to block the funds till the process completes so that those funds arn't available for any other operation.
How is Wallet Transaction API different from Transaction report API?
When the Payin is COMPLETED, Finmo will CREDIT the Payin wallet and DEBIT the Fees wallet. All these transactions will appear as separate line item under the respective wallets, so if you list all wallet transaction with appropriate wallet_id you will see those transactions.
However the Transaction report will have only one line item for the above Payin transaction. This transaction will have everything in one line item for e.g. Total amount paid, Total fees charged, Total Taxes charged, Amount without taxes, Transactions settled or not, Transaction Reconciled or not etc.
List all Wallet transactions
Use this API to fetch all wallet transactions.
You can filter the results based on multiple query params. This API is paginated. The default is 10 transactions per page. You can control this using the limit and page query parameters.