Skip to main content

Wallet Management API (v1)

Download OpenAPI specification:Download

API for manage wallet and owner data (v1.0.154)

Buckets

GetWalletBuckets

Gets all Buckets associated to the given Wallet

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

ResyncBuckets

Resyncs every Partner's Bucket for each Wallet with at least one deposit

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

Diagnostics

GetDiagnosticsInfo

Get current platform diagnostics data

Responses

Response samples

Content type
No sample

Statistics

GetPartnerWalletsStatistics

Get the Partner's wallets aggregated statistics

Responses

Response samples

Content type
No sample

GetDealerWalletsStatistics

Get the Originating Dealer's wallets aggregated statistics

path Parameters
dealerKey
required
string

Responses

Response samples

Content type
No sample

Wallets

GetWallet

Get wallet data using provided identifier

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

UpdateWallet

Allows updating TaxId and Email of an existing Wallet

path Parameters
walletId
required
string <uuid>

Wallet identifier

Request Body schema:
required

Request containing new TaxId and Email values

taxId
required
string non-empty

Owner TaxId

email
required
string non-empty ^(?!.*\.\.)(?!.*\+$)[a-zA-Z0-9!#$%&'*\/=?^_`{...

Owner Email

Responses

Request samples

Content type
{
  • "taxId": "string",
  • "email": "string"
}

Response samples

Content type
No sample

GetWalletBalance

Get wallet balance using provided identifier

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

GetAllWallets

Get all wallets on platform phase and will be removed as soon as the application goes live! ***

query Parameters
fromDate
string <date-time>
toDate
string <date-time>
pageSize
integer <int32>
Default: 50
pageNumber
integer <int32>
Default: 0

Responses

Response samples

Content type
No sample

CreateWallet

Creates a new wallet on platform

Request Body schema:
required

Request for creation

taxId
required
string non-empty

Owner tax identifier

firstName
required
string non-empty

Owner first name

lastName
required
string non-empty

Owner last name

phoneNumber
required
string non-empty

Owner phone number

email
required
string non-empty ^(?!.*\.\.)(?!.*\+$)[a-zA-Z0-9!#$%&'*\/=?^_`{...

Owner e-mail

originatingDealerKey
required
string non-empty

Original dealer for which the wallet was created

Responses

Request samples

Content type
{
  • "taxId": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "phoneNumber": "string",
  • "email": "string",
  • "originatingDealerKey": "string"
}

Response samples

Content type
No sample

GetSctInstructions

Gets the instructions to send an SCT in order to recharge the wallet

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

UpdateWalletAttributes

Allows updating FirstName, LastName and PhoneNumber of an existing Wallet

path Parameters
walletId
required
string <uuid>

Wallet identifier

Request Body schema:
required

Request containing new FirstName, LastName, PhoneNumber and optional Residence values

firstName
required
string non-empty

Owner first name

lastName
required
string non-empty

Owner last name

phoneNumber
required
string non-empty

Owner phone number

addressStreet
string or null

Street of residence

addressNumber
string or null

Street number

zipCode
string or null

City postal code

city
string or null

City of residence

province
string or null

Province of residence

country
string or null

Country of residence

object or null

Metadata for the wallet

Responses

Request samples

Content type
{
  • "firstName": "string",
  • "lastName": "string",
  • "phoneNumber": "string",
  • "addressStreet": "string",
  • "addressNumber": "string",
  • "zipCode": "string",
  • "city": "string",
  • "province": "string",
  • "country": "string",
  • "metadata": {
    }
}

Response samples

Content type
No sample

UpdateWalletIban

Sets the given IBAN to be verified and then associated to the Wallet

path Parameters
walletId
required
string <uuid>

Wallet identifier

Request Body schema:
required

Request containing the IBAN and BIC to associate to the Wallet

iban
string or null

Owner IBAN

bic
string or null <= 11 characters

BIC associated to the IBAN (needed only if IBAN is not Italian)

Responses

Request samples

Content type
{
  • "iban": "string",
  • "bic": "string"
}

Response samples

Content type
No sample

DeleteWalletIban

Removes the associated IBAN from the given Wallet, regardless of the validation state

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

SuspendWallet

Suspend an existing wallet using its identifier. Suspension deny to the end user the usage of his wallet for any operation (deposit, payment, withdrawal, etc).

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

ReactivateWallet

Reactivates an existing suspended wallet using its identifier.

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

CloseWallet

Close an existing suspended wallet using its identifier.

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

ReopenWallet

Reopens an existing closed wallet using its identifier.

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

SearchWallet

Searches for existing Wallets matching each given parameter.

NOTE: Ignores missing, null, empty of white space only search parameters

query Parameters
pageSize
integer <int32>
Default: 50

Number of wallets per page

pageNumber
integer <int32>
Default: 0

Page number

Request Body schema:
required

Request containing search fields

taxId
string or null

Owner tax identifier: exact match, case insensitive

firstName
string or null

Owner first name: partial match (contains), case insensitive

lastName
string or null

Owner last name: partial match (contains), case insensitive

phoneNumber
string or null

Owner phone number: partial match (contains), case insensitive

email
string or null

Owner e-mail: partial match (contains), case insensitive

iban
string or null

IBAN of wallet owner: exact match, case insensitive

isSuspended
boolean or null

If wallet is suspended (if null searches for both suspended and not suspended ones)

NOTE: cannot be false if IsClosed is true

isClosed
boolean or null

If wallet is closed (if null searches for both closed and open ones)

hasNeverBeenUsed
boolean or null

Searches only for Wallets that never executed any Operation (LastUsageDate never set)

Responses

Request samples

Content type
{
  • "taxId": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "phoneNumber": "string",
  • "email": "string",
  • "iban": "string",
  • "isSuspended": true,
  • "isClosed": true,
  • "hasNeverBeenUsed": true
}

Response samples

Content type
No sample

GetWalletLimits

Get wallet limit using provided identifier

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample

GetWalletContractTemplate

Gets the Pdf file for the Wallet Contract template

Responses

Response samples

Content type
No sample

GetWalletContractFilled

Gets the Pdf file for the Wallet Contract filled with the given Wallet data

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

SignWalletContract

Signs the Wallet Contract after filling it with the given Wallet data

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

GetWalletContractSigned

Gets the Pdf file for the Wallet Contract once it's filled and signed

path Parameters
walletId
required
string <uuid>

Responses

Response samples

Content type
No sample

DestroyWallet

*** ATTENTION: THIS ENDPOINT IS AVALIABLE ONLY IN TESTING AND DEVELOPMENT ENVIRONMENTS *** Deletes a Closed Wallet alongside any associated Operation, Group, SDD mandate and Transaction.

path Parameters
walletId
required
string <uuid>

Wallet identifier

Responses

Response samples

Content type
No sample