Part 3: Managing Client Information
For individual clients only
Last updated
For individual clients only
Last updated
Client Information is the key asset from Fiat24 and is also very sensitve data which can cause irrevocable damage to the client.
Only for 4-Digit and 3-Digit Developer NFT projects.
This guide illustrates how Fiat24 separately manages the client information in a dedicated site id.fiat24.com.
The parameter
walletTokenId
needs to be added in case you want to customise the Login Page with your colors and name
Our onboarding process involves several steps to verify the identity of the customer and ensure that they meet the Swiss KYC/AML requirements to open an account with Fiat24. Here is a general overview of the onboarding process with us:
Check Profile This step check the eligibility of the client to open the account with Fiat24. It involves domicile and nationality check, preconditional risk questionaires and collect client's email and phone number. Fiat24 conducts background checks on the customer to verify their profile and ensure that they meet our requirements to open an account.
Check Address We comply with Swiss regulation to verify user's residential address by GPS location. This step should be done within the browsers such as Chrome or Safari, but not the browser inside the crypto wallet, which usually disabled the Location Services for better safety. According the related regulation, the user must be within 2 km from the given address.
Scan Passport Fiat24 will verify the user's identity by asking for the passport scan. The user need to hold a NFC chip enabled passport to confirm their identity. User need to download the ePassport app ReadID Ready and scan the generated QR code to continue.
Once the customer's identity has been verified and their background checks have been completed, Fiat24 will set up their account. It will take from minutes to maximal 2 business days.
Once the client has completed the onboarding process and their account has been funded, they can start using the Fiat24's services, such as making deposits, withdrawing funds, and conducting transactions.
Only for 2-Digit and 1-Digit Developer NFT projects.
Using API to deliver onboarding client data are restricted functions exclusively available to internal, trusted systems, ensuring that only authorised applications and users can access sensitive operations or data.
The registration information has been submitted successfully, and all requirements have been met. Therefore, the client has been successfully accepted.
Many fields in the request JSON body are enumerated values. The following JavaScript code provides a reference for all possible values.
Fiat24 NFT holders are responsible for keeping their personal information up to date. This section introduces two methods for viewing and updating client and debit card information.
Fiat24 enables all developer projects, regardless of their Developer NFT digits, to access both the ID module and API integration for managing client and debit card information.
Here is the procedure for users to update the information.
Connect to https://id.fiat24.com Log in to the dapp with the wallet address holding the Fiat24 NFT. If the NFT is in any verifed status, such as Live, the client will successfully log into the portal. Once the client is logged in, navigate to the Identity section from the menu bar.
Update the personal information In the Identity section, the client can update her/his email address, phone number, and other personal details.
Managing the Debit Card Storing our Debit Card data securely is extremely important in order to protect the financial information and prevent unauthorized access or fraud to Fiat24 users. This information can include the card number, expiration date, CVV code, and in some cases, the name and address. If this information falls into the wrong hands, it can be used to make unauthorized purchases or gain access to your bank account. When the clients log into https://id.fiat24.com and go to the Debit Card section, she/he can:
See the complete card information All card information is displayed here, include card holder name, card number, expiry and CVV.
Limit management Client can see all limits applied to the card, include daily limits, weekly limits, monthly limits and single transaction limits. Above them, we offer an overall budget level limit to be approved by the user with their signature of the crypto wallet. The default value is 5000 EUR. The budget approval button is marked in orange below.
Control the card Clients are able to enable or disable the card the card
This API enables the secure update of a user's registered email address, a critical function as the email serves as the primary channel for receiving one-time passwords (OTPs) and other sensitive authentication communications. To ensure security, the API requires robust verification—such as multi-factor authentication (MFA) or confirmation via the existing email—before processing any changes. Once validated, the system seamlessly updates the email across all linked services, ensuring uninterrupted delivery of OTPs and essential notifications.
Email format is ok, and there is no duplication.
Once successfully get the OTP, call the API again with it, before it expires.
Response
Successfully updated the new email.
This API enforces strict email uniqueness validation, ensuring that no single email address can be registered to multiple user accounts. When a user attempts to update their email, the system automatically checks for duplicates—rejecting the new email immediately if it is already associated with an existing account. This prevents individuals from linking the same email to multiple profiles, maintaining data integrity and reducing the risk of fraud or account misuse. By enforcing a one-email-per-account rule, the API enhances security, simplifies user management, and ensures that critical communications—such as OTPs and notifications—are delivered exclusively to the intended recipient.
This API enables the seamless creation of a MasterCard debit card for a designated nftId
, linked directly to the user’s account.
Response:
Successfully set the new currency.
This API provides a secure and efficient way to block or unblock a debit card for a specific user, enabling instant control over card activity to prevent unauthorized transactions or reactivate access when needed. The API immediately updates the card’s status, triggering real-time fraud prevention measures or restoring functionality upon request. The API ensures compliance with banking regulations while offering seamless integration with existing systems for automated or manual card management.
Response:
Successfully set the new currency.
This API allows for the secure and immediate deactivation of a digital token associated with a debit card, such as those generated for mobile payment platforms like Apple Pay, Google Pay, or Samsung Pay. When a card is lost, stolen, or compromised, this API ensures that the linked digital token is revoked, preventing unauthorized transactions while keeping the physical card active if needed. The process is automated, reliable, and works across multiple tokenization platforms.
Response:
Successfully set the new currency.
This API enables users to change the Default Currency for their debit card, providing greater flexibility and convenience for international transactions. The API updates the card’s settings in real-time, ensuring that future purchases or online payments are automatically processed in the preferred currency, when the Direct Pay balance is insufficient.
This feature helps users avoid unnecessary foreign exchange fees, streamline cross-border spending, and optimize transaction transparency.
Response:
Successfully set the new currency.
Blabla