Skip to content

Balances

Balance of a specific Wallet

This checks the current Balance of the Wallet (how much money there is), making sure the funds have arrived. Note that the walletId is expected as a query parameter.

bash
curl -X POST {baseUrl}/v1/balances?walletId={walletId} \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \

Outputs a Balance object, with both the Authorized Balance (authorizedBalance) and Balance (currentBalance).

json
{
    "balances": [
        {
            "walletId": 1317558,
            "currentBalance": 280,						// Actual Balance
            "authorizations": 0,						// Currently pending authorizations
            "authorizedBalance": 280,					// Balance, minus pending authorizations
            "currency": "EUR",							// Currency of the balance
            "calculationDate": "2022-03-01 15:52:40"	// When the Balance was last actualized
        }
    ]
}

Balances of all Wallets

You can retrieve the Balances of multiple Wallets related to the same User. In this case, you provide a userId instead of a walletId in the query parameters.

bash
curl -X GET {baseUrl}/v1/balances?userId={userId} \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \

Outputs as many Balances as the User has Wallets.

json
{
	"balances": [
		// first Wallet
		{
			"walletId": "<integer>",			
			"currentBalance": "<decimal>",		// Actual Balance
			"authorizedBalance": "<decimal>",	// Balance minus pending authorizations
			[...] // some attributes are hidden
		},
		// second Wallet
		{
			"walletId": "<integer>",			
			"currentBalance": "<decimal>",		// Actual Balance
			"authorizedBalance": "<decimal>",	// Balance minus pending authorizations
			[...] // some attributes are hidden
		},
		// n Wallet
		{
			"walletId": "<integer>",			
			"currentBalance": "<decimal>",		// Actual Balance
			"authorizedBalance": "<decimal>",	// Balance minus pending authorizations
			[...] // some attributes are hidden
		}
	]
}

Check the balance history

This checks the evolution of the balance over time. Only the walletId is mandatory, it is expected in the URL. It can optionnaly by restricted to a timeframe using dateFrom and dateTo.

bash
curl -X GET {baseUrl}/core-connect/balances/{walletId}?dateFrom=2021-11-01&dateTo=2022-10-01 \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json'
json
{
	"2021-03-31T09:50:02+00:00": {
		"solde": 51.25,
		"authorizedBalance": 51.25,
		"currency": "EUR"
	},
	"2021-02-04T13:20:02+00:00": {
		"solde": 170.00,
		"authorizedBalance": 170.00,
		"currency": "EUR"
	},
	// [...] more items are hidden
}
Warning icon

Caution – Date expected format is YYYY-MM-DD

The timeframe dates do not follow the standard format and are instead expected as YYYY-MM-DD.