# Introduction

Operations stand for banking operations originating from or targeting a Wallet (i.e., Card Transactions, Payins, Payouts, and Transfers) and their refunds. Each Operation summarizes the initial transaction with read-only information such as the nature, status, amount, origin, and destination.

Therefore, you may use Operations as a single source of information. They are what end users generally expect to see as a table or timeline when they log into their bank website/app.

Tip – Operations are available in CSV format

You can also export the information using the Reports feature.

Alert – The Operation object will change soon

Operations v2 is available in Sandbox only, introducing a change in structure for the Operation object. If you have any doubts about how to migrate, contact your Treezor Account Manager.

# Available operations (`operationType`)

The operationType attribute allows you to identify what kind of banking operation is concerned.

The following types are available:

`operationType`	Initial operation
`bankDirectDebit`	SEPA Direct Debit (SDD)
`bankTransfer`	SEPA Transfer
`cardTopup`	Incoming funds from Card
`cardTransaction`	Outgoing Card payment
`check`	Cheque
`creditNote`	Wallet-to-wallet Transfers with a `transferTypeId` value of `4`. Such transfers allow you to handle reimbursement of charges.
`fees`	Wallet-to-wallet Transfers with a `transferTypeId` value of `3`. Such transfers allow you to debit fees from end users wallets. They are identified as such in Account Statements.
`instantBankTransfer` v2 only	Instant SEPA Transfer
`walletTransfer`	Wallet-to-wallet Transfers

You may find the _refund suffix, indicating a refund or a canceled operation, but such types will disappear in Operations v2.

# Key attributes

Below are a few of the most important attributes.

Attribute	Type	Description
`operationType`	string	The type of bank operation, providing functional context about the initial operation.
`initialFlow`v2 only	string	Provides technical context about the initial operation: `payin`, `payinRefund`, `payout`, `payoutRefund`, `transfer`, `cardTransaction`. You can fetch the initial operation by making the corresponding request (using the `objectId` as a path parameter).
`amount`	integer	The amount of the operation in cents (e.g., `100` stands for 1)
`walletId`	integer	The unique identifier of the wallet associated with the operation.
`direction`	string	Direction of the operation, which can either be: `CREDIT` – The funds are credited to the Wallet `DEBIT` – The funds are debited from the Wallet
`objectId`	string	The unique identifier of the object the operation relates to (e.g., the initial `cardTransaction`).
`label`	string	Information that you can expose to your end users. The label content differs depending on the context.
`metadata`	object	Details about the initial operation.
`status`	string	The status of the operation, which can be: `AUTHORIZED` `DECLINED` `SETTLED` `CANCELED`
`creation`	string	The date and time at which the object the operation relates to was created. Format: RFC3339 standard.
`settlement`	string	The date and time at which the object the operation relates to was settled on the Wallet. Format: RFC3339 standard.

Swagger – Refer to endpoint documentation

For a complete list of Operation attributes, check the Operations endpoint in the Swagger.

# Structure

# Current

{
  "operationType": "bankTransfer",
  "amount": {
    "amount": 6300,
    "currency": "EUR"
  },
  "walletId": 630632,
  "direction": "DEBIT",
  "objectId": 408265455,
  "label": "Bank Transfer (408265455)",
  "externalReference": null,
  "metadata": null,
  "status": "AUTHORIZED",
  "date": {
    "creation": "2023-08-19T06:08:23+02:00",
    "settlement": null
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# v2

{
    "operationType": "bankTransfer",
    "initialFlow": "payout",
    "amount": {
      "amount": 6300, 
      "currency": "EUR", 
    },
    "walletId": 630632, 
    "direction": "DEBIT", 
    "objectId": "408265455", 
    "label": "Theo West Virement de M Alex Oak", 
    "metadata": {
        "payoutTag": "VO - 1234554321",
        "beneficiaryId": "404897",
        "label": "Virement de M Alex Oak",
        "codeStatus": "140005",
        "informationStatus": "",
        "supportingFileLink": "",
    },
    "status": "AUTHORIZED", 
    "date": {
      "creation": "2023-08-19T06:08:23+02:00", 
      "settlement": null  
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# Endpoints

Endpoint	Description	Scope
`/core-connect/operations`	Search Operations	`read_only`
`/core-connect/operations/{walletId}/report`	Create a Report	`read_only`
`/core-connect/operations/{walletId}/report`	Get a Report	`read_only`

← Emulation Operations (current) →