Transactions

Transactions are a read-only representation of banking operations on a Wallet.

Best practice – Use the Operations feature

If you are using Treezor Connect, the Operations endpoint supersedes this one.

Key attributes

Attribute	Type	Description
transactionId	integer	The unique identifier of the transaction.
createdDate	string	The date and time at which the transaction was created.
valueDate	string	The date on which the payment was applied.
executionDate	string	The date on which the transaction was executed.
transactionType	string	The type of the transaction. See Transaction Types list.
name	string	The name of the transaction.
foreignId	integer
walletDebitBalance	string	The balance of the debited Wallet (if any).
walletCreditBalance	string	The balance of the credited Wallet (if any).
walletDebitId	integer	The unique identifier of the debited Wallet (if any).
walletCreditId	integer	The unique identifier of the credited Wallet (if any).
amount	string	The amount of the transaction.
currency	string	The currency of the transaction (format: ISO-4217).

Transaction Types (transactionType)

Below the list of possible values for the transactionType attribute.

Id	Name	Additional information
1	Payin	Transaction from an external account into a Treezor Wallet.
2	Payout	Transaction from a Wallet to an external account.
3	Transfer	Wallet-to-Wallet transfer.
5	Payin Refund	Refund of a past transaction made into a Treezor Wallet.
10	Card Transaction	Learn more in the Card transactions section of the documentation.
11	Payout Refund	Refund of a past transaction made from a Wallet to an external account.
13	Payin Acquiring	Transaction capturing funds from a third-party card to credit a Treezor Wallet. Learn more.
14	Payin Refund Acquiring	Refund of a card top-up. Learn more.
15	SCTR Inst	Received SEPA Instant Credit Transfer
17	Payin SCT Instant Recall	Learn more in the Recalls & RROs article.
18	Payout SCT Instant Emit	Emitted SEPA Instant Credit Transfer
19	Payin SCT Instant Emit Recall	Learn more in the Recalls & RROs article.
20	Credit Transfer Returned	SCT Return.
21	Check Payin	Check cashing
22	SDDE	Emitted SEPA Direct Debit
23	SDDR	Received SEPA Direct Debit
24	SDDR Reversal	SDDR refused after effective date.
25	SCTR Recall	Learn more in the Recalls & RROs article.
26	Check Refund	Refund of a check cashing.
27	SCTR	Received SEPA Credit Transfer

Structure

JSON

{
	"transactionId": 0,
	"walletDebitId": 0,
	"walletCreditId": 0,
	"transactionType": "string",
	"foreignId": 0,
	"name": "string",
	"description": "string",
	"valueDate": "string",
	"executionDate": "string",
	"amount": "string",
	"walletDebitBalance": "string",
	"walletCreditBalance": "string",
	"currency": "string",
	"createdDate": "string",
	"totalRows": 0
}

Retrieving transactions

The following example searches for Payin Transactions per userId.

CURL

curl -X GET {baseUrl}/v1/transactions?userId={userId}&transactionType=Payin \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json'

Returns an array of Transaction objects.

JSON

{
    "transactions": [
        {
            "transactionId": 4823484,
            "walletDebitId": 9,
            "walletCreditId": 2540896,
            "transactionType": "Payin",
            "foreignId": "1234626",
            "name": "1234626",
            "description": "Payin bank transfer",
            "valueDate": "2023-12-21",
            "executionDate": "2023-12-21",
            "amount": "101.25",
            "walletDebitBalance": "0.00",
            "walletCreditBalance": "50203.75",
            "currency": "EUR",
            "createdDate": "2023-12-21 12:11:34",
            "totalRows": "2"
        },
        {
            "transactionId": 4823455,
            "walletDebitId": 9,
            "walletCreditId": 2540896,
            "transactionType": "Payin",
            "foreignId": "1234606",
            "name": "1234606",
            "description": "Payin bank transfer",
            "valueDate": "2023-12-21",
            "executionDate": "2023-12-21",
            "amount": "101.25",
            "walletDebitBalance": "0.00",
            "walletCreditBalance": "50102.50",
            "currency": "EUR",
            "createdDate": "2023-12-21 12:05:40",
            "totalRows": ""
        }
	]
}

Retrieving a transaction

CURL

curl -X GET {baseUrl}/v1/transactions/{transactionId} \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \

Returns the corresponding Transaction object.

JSON

{
    "transactions": [
        {
            "transactionId": 4823455,
            "walletDebitId": 9,
            "walletCreditId": 2540896,
            "transactionType": "Payin",
            "foreignId": "1234606",
            "name": "1234606",
            "description": "Paiement ",
            "valueDate": "2023-12-21",
            "executionDate": "2023-12-21",
            "amount": "101.25",
            "walletDebitBalance": "0.00",
            "walletCreditBalance": "50102.50",
            "currency": "EUR",
            "createdDate": "2023-12-21 12:05:40",
            "totalRows": "1"
        }
    ]
}

Endpoints

Endpoint	Scope
/v1/transactions Search for transactions	read_write
/v1/transactions/{transactionId} Retrieve a transaction	read_write