Creation

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

Treezor sends a wallet.create webhook regardless the type of Wallet created.

Prerequisites – Ensure the User is fit to have a Wallet

Users must have a VALIDATED status, and Legal Entities must have a legal representative and majority shareholder declared in order to own a Wallet.

Payment Account Wallet

The Payment Account Wallet has a walletTypeId of 10. This type of wallet requires KYC validation of the associated User, and can only be created if the Wallet owner has a VALIDATED status.

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.
bic	string	The country in which the wallet is domiciled. The BIC is required depending on your configuration; see Local IBAN

API – API Reference available

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

Request

Endpoint: /v1/wallets

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. While this type of wallet doens't need KYC validation of the associated User, they can only be created if they have a VALIDATED status.

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.
bic	string	The country in which the wallet is domiciled. The BIC is required depending on your configuration; see Local IBAN

API – API Reference available

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

Request

Endpoint: /v1/wallets

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.