Creation

Find in this article examples on how to create different types of wallets. Some wallets might require you contact Treezor to create them.

Regardless the type of Wallet created, the wallet.create webhook is sent upon creation.

Information – Feature also available on the Dashboard

Wallets can also be managed via the Dashboard.

Payment Account Wallet

The Payment Account Wallet has a walletTypeId of 10. This type of wallet requires KYC validation of the associated User.

Mandatory parameters

Below are the necessary parameters to create a Payment Account Wallet.

Attribute	Type	Description
tariffId	integer	The fees applied to the Wallet, as defined by your contract with Treezor. Usually required, but may have a default value set by Treezor.
walletTypeId	integer	10 for Payment Account Wallet.
userId	integer	The unique identifier of the User who owns the Wallet.
currency	string	The currency of the Wallet. Can only be EUR.
eventName	string	The name of the Wallet.

API – Swagger documentation available

For a complete list of Wallet attributes, check the Wallets section of the Swagger.

Request

Here is the request to create a Wallet:

CURL

curl -X POST {baseUrl}/v1/wallets \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \
	-d '{payload}'

Here is an example of {payload}:

JSON

{
	"walletTypeId":10,
	"tariffId":{tariffId},
	"userId":123456,
	"currency":"EUR",
	"eventName":"My Payment Account Wallet"
}

Returns a Wallet object, with its id. An IBAN (iban) and BIC (bic) are also automatically assigned and populated. You may create Virtual IBANs in a second step.

JSON

{
    "wallets": [
        {
            "walletId": 2605378,
            "walletTypeId": 10,
            "walletStatus": "VALIDATED",
            "codeStatus": 120005,
            "informationStatus": "",
            "walletTag": "",
            "userId": 100078924,
            "userLastname": "Alex",
            "userFirstname": "Oak",
            "jointUserId": 0,
            "tariffId": 396,
            "eventName": "Event_test",
            "eventAlias": "event-test-65aa83976d9df",
            "eventDate": "2024-01-26",
            "eventMessage": "",
            "eventPayinStartDate": "2024-01-19",
            "eventPayinEndDate": "0000-00-00",
            "contractSigned": 0,
            "bic": "TRZOFR21XXX",					// BIC automatically assigned to the Wallet
            "iban": "FR761679800001000012345678",	// IBAN automatically assigned to the Wallet
            "urlImage": "",
            "currency": "EUR",
            "createdDate": "2024-01-19 15:13:43",
            "modifiedDate": "0000-00-00 00:00:00",
            "payinCount": 0,
            "payoutCount": 0,
            "transferCount": 0,
            "solde": 0,
            "authorizedBalance": 0,
            "totalRows": 1,
            "country": "FR"
        }
    ]
}

Treezor also sends the wallet.create webhook.

Electronic Money Wallet

The Electronic Money Wallet has a walletTypeId of 9. This type of wallet doens't need KYC validation of the associated User.

Mandatory parameters

Below are the necessary parameters to create an Electronic Money Wallet.

Attribute	Type	Description
tariffId	integer	The fees applied to the Wallet, as defined by your contract with Treezor. Usually required, but may have a default value set by Treezor.
walletTypeId	integer	9 for Electronic Money Wallet.
userId	integer	The unique identifier of the User who owns the Wallet.
currency	string	Currency of the Wallet. Can only be EUR.
eventName	string	The Name of the Wallet.

API – Swagger documentation available

For a complete list of Wallet attributes, check the Wallets section of the Swagger.

Request

Here is the request to create a Wallet:

CURL

curl -X POST {baseUrl}/v1/wallets \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \
	-d '{payload}'

Here is an example of {payload}:

JSON

{
	"walletTypeId":9,
	"tariffId":{tariffId},
	"userId":123456,
	"currency":"EUR",
	"eventName":"My Electronic Money Wallet"
}

Returns a Wallet object with its id. An IBAN (iban) and BIC (bic) are also automatically assigned and populated. You may create Virtual IBANs in a second step.

JSON

{
    "wallets": [
        {
            "walletId": 2605123,
            "walletTypeId": 0,
            "walletStatus": "VALIDATED",
            "codeStatus": 120005,
            "informationStatus": "",
            "walletTag": "",
            "userId": 100078924,
            "userLastname": "Alex",
            "userFirstname": "Oak",
            "jointUserId": 0,
            "tariffId": 396,
            "eventName": "Event_test",
            "eventAlias": "event-test-65aa83976d9df",
            "eventDate": "2024-01-26",
            "eventMessage": "",
            "eventPayinStartDate": "2024-01-19",
            "eventPayinEndDate": "0000-00-00",
            "contractSigned": 0,
            "bic": "TRZOFR21XXX",					// BIC automatically assigned to the Wallet
            "iban": "FR761679800001000012345678",	// IBAN automatically assigned to the Wallet
            "urlImage": "",
            "currency": "EUR",
            "createdDate": "2024-01-19 15:13:43",
            "modifiedDate": "0000-00-00 00:00:00",
            "payinCount": 0,
            "payoutCount": 0,
            "transferCount": 0,
            "solde": 0,
            "authorizedBalance": 0,
            "totalRows": 1,
            "country": "FR"
        }
    ]
}

Treezor also sends the wallet.create webhook.

Mirror or Technical Wallet

The Mirror or Technical Wallet has a walletTypeId of 13 and cannot be created manually.

Caution – Never use Wallet 13 for SEPA Transfers

Although Mirror and Technical Wallets have an IBAN, these IBAN should never be used to emit or receive SEPA Transfers.

Electronic Money Card

The Electronic Money Card type of wallet has a walletTypeId of 14 and cannot be created manually.

Caution – Never use Wallet 14 for SEPA Transfers

Although Mirror and Technical Wallets have an IBAN, these IBAN should never be used to emit or receive SEPA Transfers.