Skip to main content

Wallet Management

API guides for creating, querying, updating, and managing the lifecycle of Wallets in the P1 platform.

Overview

The Wallet is the central entity of the P1 platform: it holds the user's balance and is the subject of every financial operation (top-up, payment, refund). Before executing any transaction, you need to have created and configured a Wallet for the user. This section covers the full Wallet management lifecycle through the Wallet Management API.

Available guides​

  • Create Wallet — Register a new Wallet for a user who has completed the onboarding flow. Requires the user's personal data (name, tax code, phone number, email, IBAN) and returns the unique Wallet identifier used in all subsequent operations.
  • Get Wallet — Retrieve the current state of a Wallet: balance, status, personal data, and associated IBAN. Use this to display the account summary in the consumer-facing app or to validate the Wallet before initiating a transaction.
  • Update Wallet — Modify Wallet attributes such as the user's contact information or linked IBAN. Changes to the IBAN trigger a re-validation flow.
  • Suspend / Reactivate Wallet — Temporarily block all operations on a Wallet (e.g., in case of a fraud signal or a user request) and reactivate it when appropriate. A suspended Wallet cannot send or receive payments.