Skip to content

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

operationTypeInitial operation
bankDirectDebitSEPA Direct Debit (SDD)
bankTransferSEPA Transfer
cardTopupIncoming funds from Card
cardTransactionOutgoing Card payment
checkCheck
creditNoteWallet-to-wallet Transfers with a transferTypeId value of 4. Such transfers allow you to handle reimbursement of charges.
feesWallet-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 onlyInstant SEPA Transfer
walletTransferWallet-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.

AttributeTypeDescription
operationTypestringThe type of bank operation, providing functional context about the initial operation.
initialFlowv2 onlystringProvides 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).
amountintegerThe amount of the operation in cents (e.g., 100 stands for 1)
walletIdintegerThe unique identifier of the wallet associated with the operation.
directionstringDirection of the operation, which can either be:
  • CREDIT – The funds are credited to the Wallet
  • DEBIT – The funds are debited from the Wallet
objectIdstringThe unique identifier of the object the operation relates to (e.g., the initial cardTransaction).
labelstringInformation that you can expose to your end users. The label content differs depending on the context.
metadataobjectDetails about the initial operation.
statusstringThe status of the operation, which can be: AUTHORIZED DECLINED SETTLED CANCELED
creationstringThe date and time at which the object the operation relates to was created.
Format: RFC3339 standard.
settlementstringThe date and time at which the object the operation relates to was settled on the Wallet.
Format: RFC3339 standard.

Structure

v2

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

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

EndpointScope
/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