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 is changing

Operations v2 is available in Sandbox, introducing a change in structure for the Operation object. Contact Treezor if you have any doubts about how to migrate.

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	Check
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, chargeback. 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.

Structure

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  
    }
}

Legacy

{
  "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
  }
}

Endpoints

Endpoint	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