Migrazione degli abbonati esistenti a 4Geeks Payments
🤖 Spiega con l'intelligenza artificiale
La migrazione della base di abbonati a una nuova piattaforma di pagamento è un processo critico che richiede precisione per garantire la continuità delle entrate. 4Geeks Payments è progettato per rendere questa transizione senza problemi, aiutandoti a consolidare la fatturazione, ridurre l’abbandono involontario tramite tentativi intelligenti e offrire una migliore esperienza cliente con un portale self-service dedicato.
Questa guida delinea le strategie più efficaci per spostare i tuoi clienti ricorrenti esistenti su 4Geeks Payments senza interrompere il loro servizio.
Prerequisiti¶
Prima di iniziare la migrazione, assicurati di soddisfare i seguenti requisiti:
- Account verificato: Un account 4Geeks Payments verificato (modalità di produzione abilitata).
- Elenco clienti: Un elenco dei tuoi attuali clienti (Nome, Email) e dei loro piani attivi.
- Piani creati: I tuoi piani di abbonamento già creati nella 4Geeks Console (Sales > Recurring Plans).
Strategie di migrazione¶
Esistono tre modi principali per migrare gli abbonati. Scegli quello che meglio si adatta alle tue risorse tecniche e alle dimensioni dell’azienda.
Metodo 1: Il “Nuovo inizio” (Consigliato per precisione)¶
Questo metodo prevede l’invito dei clienti attivi a riabbonarsi tramite un link sicuro. Sebbene richieda un’azione da parte del cliente, è spesso la mossa più salutare per la tua azienda perché aggiorna le carte scadute, verifica le informazioni di contatto e garantisce la conformità alla Strong Customer Authentication (SCA).
- Crea i tuoi piani: Assicurati che i tuoi piani in 4Geeks corrispondano ai tuoi vecchi piani (prezzo, intervallo, valuta).
- Genera inviti:
- Vai a Sales > Recurring Plans nella 4Geeks Console.
- Seleziona il piano a cui vuoi migrare gli utenti.
- Clicca su Add Subscriber.
- Inserisci l’email del cliente.
- Invia l’invito: 4Geeks invierà un’email ufficiale e sicura al tuo cliente contenente un link per attivare il suo nuovo abbonamento.
- Annulla i vecchi abbonamenti: Una volta che un cliente conferma il nuovo abbonamento in 4Geeks, cancella il suo profilo nel tuo fornitore precedente per evitare la doppia fatturazione.
Metodo 2: Migrazione programmatica (Per sviluppatori)¶
Se hai una vasta base di utenti e risorse di sviluppo, puoi automatizzare il processo utilizzando l’API di 4Geeks Payments.
- Recupera ID piano: Nella Console, apri i dettagli del piano per trovare il suo endpoint/ID API univoco.
- Scrivi lo script di migrazione: Scrivi uno script per scorrere il database dei clienti.
- Crea abbonamenti: Invia una richiesta POST per ogni cliente all’URL univoco del piano.
- Dati richiesti: Devi includere il nome e l’email del cliente nel corpo della richiesta.
- Gestisci i dettagli di pagamento: Poiché non puoi trasferire dati grezzi della carta di credito tramite API (a causa della conformità PCI), l’API avvierà un abbonamento “In sospeso”. Puoi quindi attivare un’email chiedendo all’utente di aggiornare semplicemente il metodo di pagamento nel Portale Clienti.
Metodo 3: Migrazione token (Solo Enterprise)¶
Se hai migliaia di abbonati e token di carte di credito attivi con un fornitore conforme a PCI (come Stripe o PayPal), potresti essere in grado di trasferire i dati di pagamento direttamente senza chiedere agli utenti di inserirli nuovamente.
- Contatta il supporto: Questo processo richiede un trasferimento sicuro backend-to-backend tra i processori di pagamento. Contatta il team di supporto Enterprise di 4Geeks per avviare una richiesta di importazione dati sicura.
Come gestire la transizione¶
Una volta migrati i tuoi abbonati, 4Geeks fornisce strumenti per gestire la relazione in corso senza sforzo.
- Portale self-service: I tuoi clienti migrati otterranno automaticamente l’accesso a un Portale Clienti. Qui possono aggiornare le proprie carte di credito, visualizzare la cronologia delle fatture e gestire lo stato dell’abbonamento senza contattare il supporto.
- Tentativi automatici: Se il pagamento di un cliente migrato fallisce (ad es. a causa di una carta scaduta), 4Geeks Payments tenta automaticamente tentativi intelligenti per recuperare le entrate prima di annullare l’abbonamento.
Casi d’uso comuni¶
Scenario 1: Passaggio dalla fatturazione manuale alla fatturazione automatizzata¶
Situazione: Un’agenzia digitale invia attualmente fatture PDF a 50 clienti mensilmente e traccia i bonifici bancari manualmente.
Soluzione: L’agenzia crea un piano “Mensile” in 4Geeks Payments. Usano il Metodo 1 per inviare un link di abbonamento sicuro a tutti i 50 clienti. I clienti inseriscono la loro carta aziendale una volta e 4Geeks automatizza la fatturazione e la generazione delle ricevute per sempre dopo.
Scenario 2: Consolidamento dei fornitori di pagamento regionali¶
Situazione: Un’azienda SaaS utilizza fornitori diversi per i clienti statunitensi e latinoamericani, ma desidera una dashboard unificata.
Soluzione: Usano il Metodo 2 (API) per creare profili cliente per tutti gli utenti in 4Geeks Payments. Indirizzano quindi tutti gli utenti al Portale Clienti di 4Geeks per aggiungere il loro metodo di pagamento locale preferito (carta, portafoglio, ecc.), sfruttando le capacità di elaborazione globale di 4Geeks.
Risoluzione dei problemi¶
Problema 1: Rifiuto del cliente durante la ri-iscrizione¶
- Soluzione: Assicurati che la valuta del piano corrisponda alla valuta della carta del cliente ove possibile per evitare rifiuti bancari. 4Geeks Payments supporta più valute e routing intelligente per ridurre al minimo i “soft declines”.
Problema 2: Doppia fatturazione¶
- Soluzione: Il periodo di migrazione è delicato. Assicurati di annullare esplicitamente l’abbonamento dell’utente nel vecchio sistema immediatamente dopo aver ricevuto il webhook “Nuovo abbonamento creato” o la notifica email da 4Geeks.
Problema 3: Dati cliente mancanti¶
- Soluzione: Se usi l’API, assicurati che il tuo payload segua rigorosamente il requisito di includere
first_name,last_nameedemailvalidi. I campi mancanti comporteranno un errore 400 Bad Request.
FAQ¶
Posso migrare da solo i token delle carte di credito attive?¶
No. Per motivi di sicurezza e conformità PCI-DSS, non è possibile esportare/importare dati grezzi della carta di credito tramite CSV o API standard. È necessario utilizzare il metodo “Invito” o contattare il supporto per una migrazione sicura dei token.
Ai miei clienti verrà addebitato immediatamente al momento della migrazione?¶
Dipende da come configuri il piano. Puoi impostare un “Periodo di prova” nelle impostazioni del piano se desideri ritardare il primo addebito per allinearlo al loro ciclo di fatturazione esistente.
- Hai ancora domande? Richiedi supporto..
- Check out the changelog.