Skip to content
/
Mobile number management
Last updated

Mobile Number Management

Creating and verifying a mobile number is a mandatory step in the customer onboarding process. A verified mobile number enables customers to receive SMS OTPs (One-Time Passwords) required for Two-Factor Authentication (2FA) and sensitive account actions.

This guide explains how to manage the mobile_number resource and lists the standardized SMS content Solaris sends to your customers.

Mandatory Requirement

A verified mobile number is required for all customers across all branches (DE, FR, IT, ES) to comply with PSD2 Strong Customer Authentication (SCA).

Data model & storage

Solaris stores mobile numbers as a dedicated mobile_number resource, separate from the person resource. This design allows for strict validation and lifecycle management.

Key constraints

  1. Uniqueness: A person can have only one verified mobile number at a time.
  2. Format: Solaris strictly validates numbers against the E.164 standard (e.g., +491512345678).
  3. Sanitization: The API automatically sanitizes input. Always use the formatted number returned in the API response, not the raw user input.
Integration Pitfall

The person resource contains a legacy attribute also named mobile_number. Do not use this attribute. It is not linked to the verified mobile_number resource and cannot be used for SCA. Always interact with the mobile_number endpoints.

Lifecycle management

Add a mobile number

To attach a mobile number to a customer, follow this authorize-confirm flow:

  1. Input: Collect the number in your frontend.
  2. Create: Call POST Create mobile number to register the resource.
  3. Authorize: Call POST Authorize to trigger the SMS OTP.
  4. Confirm: Collect the OTP from the customer and call POST Confirm to verify the number.

For a full walkthrough, see Step 2 of the Onboard a Person guide.

Change a mobile number

Mobile numbers are immutable once verified. To update a number, you must delete the existing one and create a new one.

  1. Delete: Call DELETE Remove mobile number.
    • Note: This triggers a Change Request process (often requiring 2FA if the user is already active).
  2. Re-create: Repeat the Add a mobile number flow with the new number.

If a customer has lost their device and cannot complete 2FA to authorize the deletion, they must contact Customer Support for a manual reset.

Webhooks

Subscribe to these events to sync your local database with the mobile number status.

EventDescription
PERSON_MOBILE_NUMBER_CREATEDA mobile number resource was created but is not yet verified.
PERSON_MOBILE_NUMBER_DELETEDA customer's mobile number was successfully removed. 2FA is now disabled for this customer until a new number is verified.

Appendix: SMS templates

Solaris sends standardized SMS messages for specific events. You cannot customize these texts, as they adhere to strict compliance and security standards.

Localization: Solaris automatically selects the language (EN, DE, FR, IT, ES) based on the customer's Language Settings.

CaseEnglish (EN)German (DE)French (FR)Italian (IT)Spanish (ES)
Verify mobile numberPlease verify your mobile number with the following SMS OTP: OTPBitte verifizieren Sie Ihre Handynummer mit folgender TAN: OTPVeuillez confirmer votre numéro de portable avec le code OTP suivant : OTPLa preghiamo di verificare il Suo numero di cellulare usando il seguente SMS OTP: OTPVerifique su número de móvil con el siguiente SMS OTP: OTP
Authenticate (2FA)OTP is your OTP for authorizationOTP ist Ihre OTP zur AutorisierungVoici votre code OTP OTP pour l'autorisationIl codice per confermare il Suo numero di telefono è: OTPOTP es su OTP para la autorización.
Confirm DeletionTo verify you would like to delete the mobile number you have on file, use the following SMS OTP: OTPUm die Löschung Ihrer Handynummer freizugeben, nutzen Sie bitte folgende TAN: OTPVeuillez utiliser le code OTP suivant afin de confirmer la suppression de votre numéro de portable : OTPPer confermare la Sua intenzione di cancellare il numero di cellulare registrato usare il seguente codice OTP: OTPPara verificar que desea eliminar el número de móvil que tiene archivado, utilice el siguiente SMS OTP: OTP
Deleted NotificationYour mobile number number has been removed and can no longer be used for SMS OTP authenticationIhre Handynummer number wurde entfernt und kann nicht mehr für das TAN-Verfahren genutzt werdenVotre numéro de portable number a été suppriméIl Suo numero di cellulare number è stato rimosso e non puó piú essere usato per l'autentificazione codice OTPSu número de móvil number ha sido eliminado y ya no puede ser utilizado para la autenticación de sms tan
Changed NotificationYour mobile number old_number has been replaced by new_numberIhre Handynummer old_number wurde durch new_numbers ersetztVotre numéro de portable old_numbers a été remplacé par le numéro new_numbersIl Suo numero di cellulare old_numbers è stato sostituito con new_numbersSu número de móvil old_number ha sido sustituido por new_number
Data Change (General)To authorize the data change, please use the following SMS OTP: OTPUm die Datenänderung freizugeben, nutzen sie bitte folgende TAN: OTPUtilisez le code OTP suivant afin de confirmer le changement des données : OTPPer autorizzare la modifica dei dati usare il seguente codice OTP: OTPPara autorizar el cambio de datos, por favor use el siguiente SMS OTP: OTP
Account ClosureTo complete the account closure of iban, use the following SMS OTP: OTPUm die Kontoschließung von iban freizugeben, nutzen Sie bitte folgende TAN: OTPAfin de confirmer la fermeture du compte ayant pour IBAN iban, utilisez le code OTP suivant : OTPPer completare il processo di chiusura per iban usare il seguente codice OTP: OTPPara completar el cierre de la cuenta iban, use el siguiente SMS OTP: OTP
Add Legal RepresentativeTo add name as a legal representative on your account iban, use the following SMS OTP: OTPUm name als Verfügungsberechtigten zu Ihrem Konto iban hinzuzufügen, nutzen Sie bitte folgende TAN: OTPAfin d'autoriser name à réaliser des opérations sur le compte iban, utilisez le code OTP suivant : OTPPer aggiungere name come rappresentante legale sul tuo conto iban usare il seguente codice OTP: OTPPara añadir name como representante legal en su cuenta iban, use el siguiente SMS OTP: OTP
Unauthorized Biz ChangeThere must be at least one legal representative person with a confirmed mobile number present
La présence d'au moins un représentant légal avec un numéro de téléphone mobile confirmé est requise.
Debe haber al menos una persona representante legal con un número de móvil confirmado.
SEPA TransactionTo complete the payment for iban of amount, use the following SMS OTP: OTPUm die Überweisung von amount auf IBAN iban freizugeben, nutzen Sie bitte folgende TAN: OTPAfin d'activer le paiement de amount depuis le compte iban, utilisez le code OTP suivant : OTPPer completare il pagamento per iban dell'importo di amount usare il seguente codice OTP: OTPPara completar el pago de iban de amount, use el siguiente SMS OTP: OTP
Batch SEPA TransactionTo complete the batch transaction of count transactions with a cumulative value of amount, use the following SMS OTP: OTPUm die Sammelüberweisung von count Transaktion über amount freizugeben, nutzen Sie bitte folgende TAN: OTPAfin d'autoriser l'ensemble des count virements d'un montant total de amount, utilisez le code OTP suivant : OTPPer completare il gruppo di transazioni per i seguenti conti count del valore cumulativo di amount usare il seguente codice OTP: OTPPara completar la transacción por grupo de las transacciones count con un valor acumulativo de amount, use el siguiente SMS OTP: OTP
Create Standing OrderTo issue the standing order of amount for account iban, use the following SMS OTP: OTPUm den Dauerauftrag von amount auf IBAN iban freizugeben, nutzen Sie bitte folgende TAN: OTPAfin d'autoriser l'ordre de virement permanent d'un montant de amount vers le compte iban, utilisez le code OTP suivant : OTPPer procedere con l'ordine di pagamento permanente dell'importo di amount per iban usare il seguente codice OTP: OTPPara emitir la orden permanente de amount para la cuenta iban, use el siguiente SMS OTP: OTP
Cancel Standing OrderTo delete the standing order of amount for account iban, use the following SMS OTP: OTPUm die Löschung des Dauerauftrags von amount auf IBAN iban freizugeben, nutzen Sie bitte folgende TAN: OTPAfin d'autoriser l'ordre de virement permanent d'un montant de amount vers le compte iban, utilisez le code OTP suivant : OTPPer annullare l'ordine di pagamento permanente dell'importo di amount per iban usare il seguente codice OTP: OTPPara emitir la orden permanente de amount para la cuenta iban, use el siguiente SMS OTP: OTP
Update Standing OrderTo change the standing order of amount for account iban, use the following SMS OTP: OTPUm die Änderung des Dauerauftrags von amount auf IBAN iban freizugeben, nutzen Sie bitte folgende TAN: OTPAfin de confirmer la modification du virement permanent d'un montant de amount vers le compte iban, utilisez le code OTP suivant : OTPPer modificare l'ordine di pagamento permanente dell'importo di amount per iban usare il seguente codice OTP: OTPPara cambiar la orden permanente de amount para la cuenta iban, use el siguiente SMS OTP: OTP
Timed OrderTo issue the timed order of amount for account iban, use the following SMS OTP: OTPUm die Terminüberweisung von amount auf IBAN iban freizugeben, nutzen sie bitte folgende TAN: OTPAfin d'activer l'ordre de virement d'un montant de amount vers le compte iban, utilisez le code OTP suivant : OTPPer generare l'ordine di pagamento temporaneo di amount per iban usare il seguente codice OTP: OTPPara emitir la transferencia programada de amount para la cuenta iban, use el siguiente SMS OTP: OTP
3DS Online PurchaseUse code passcode to authenticate your purchase of amount currency at merchantNutzen Sie den Code passcode um die Überweisung von amount currency an merchant zu authorisierenUtilisez le code passcode pour authentifier votre achat de amount currency chez merchantUsa il codice passcode per autenticare il tuo acquisto di amount currency presso merchantUtilice el código passcode para autenticar su compra de amount currency en merchant
Apple/Google PayYour one-time verification code to add your card to Wallet_Name is code. The code will expire in 30 minutes.Ihr einmaliger Bestätigungscode um Ihrer Karte zu Wallet_Name hinzuzufügen lautet code. Der Code läuft in 30 Minuten ab.Votre code de vérification à usage unique pour ajouter votre carte à Wallet_Name est le code. Ce code expirera dans 30 minutes.Il tuo codice di verifica una tantum per aggiungere la tua carta a Wallet_Name è code. Il codice scadrà tra 30 minuti.Su código de verificación único para agregar su tarjeta a Wallet_Name es code. El código caducará en 30 minutos.

API Reference

Explore the full technical definition for the mobile number resource.

Person Mobile Numbers

View all endpoints for creating, retrieving, and verifying mobile numbers.

Previous page
Next page