FIfinmo
Transaction

Get All Transaction

Changed on

Retrieve all wallet transactions by customer_id. It supports filtering by event type. Use this API to search and view transactions, including payin, payout, refund, virtual accounts, top-ups, and all other transfers that occur across the wallets. This single endpoint can be used for reconciliation and is equivalent to the 'Transactions' tab on the dashboard.

Transactions in this list are all COMPLETED transactions, similar to Wallet Transactions, and will provide you with the following fields:

  • Transaction date & time

  • Transaction event type

  • Transaction amount

  • Finmo transaction fee

  • Transaction settled status

  • Finmo reconciliation status

  • Transaction description

  • Customer ID

Finmo conducts daily reconciliation with multiple network partners (local banks or acquirers) involved in transactions. This helps Finmo and it’s clients to identify transactions that need assistance or got lost in transit due to communication issues.

List all transactions

Retrieve a list of all the Transactions. You can filter the list with query parameters.

This API comes with Pagination support, you can customize limit and page query parameters as per the requirements.

get/transaction

Request

  • Base URL
    https://api.finmo.net/v1
  • Auth
    HTTP basic

Query parameters

customer_idstring

Fetch all wallet transactions by Customer_id

event_typestring
Example:PAYIN

Event Type (PAYIN, PAYOUT, REFUND, VA_PAYIN etc.)

is_settledboolean
Example:true

Settlement status (true or false)

is_reconciledboolean
Example:true

Finmo reconciliation status (true or false)

created_atstring
Example:2022-02-01

UTC date. If you need to use local time then use start_time and end_time fields

start_timeinteger
Example:84600

EPOCH Timestamp

end_timeinteger
Example:84700

EPOCH Timestamp

limitinteger
Example:10

Max number of transaction record per page. Default is 10 transactions per page

pageinteger
Example:1

The page number to return. If unspecified, the first page is returned

Response

OK

request_idstring
request_timestring date-time
status_codeinteger
status_textstring
successboolean

Example response

{
  "data": [
    {
      "additional_data": null,
      "amount": 22,
      "created_at": "2022-03-20T20:24:47.534Z",
      "currency": "AUD",
      "customer_id": null,
      "event_description": "PAYIN",
      "event_id": "payin_de8faf19eaab42e790cfef65f6b109f0",
      "event_name": "PAYIN_COMPLETED",
      "event_type": "PAYIN",
      "fees_currency": "AUD",
      "fees_including_tax": 0.84,
      "fees_without_tax": 0.7,
      "invoice_id": "inv_123",
      "is_reconciled": true,
      "is_settled": false,
      "net_amount": 21.16,
      "org_id": "org_804fbb926e9d4175aa46ec67b16c820e",
      "scope": "MASTER",
      "settlement_id": null,
      "tax_on_fees": 0.14,
      "transaction_id": "txn_f8e33d81462a441bbb66c4ba9f7909f5",
      "updated_at": "2022-03-20T20:24:47.696Z"
    }
  ]
}

Changes