# 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.

Bulb icon

Tip – Operations are available in CSV format

You can also export the information using the Reports feature.

Warning icon

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.
initialFlowv2 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.
Note icon

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
Updated on: 5/15/2024, 3:02:56 PM