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. |
initialFlow v2 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:
|
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
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
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 |