Richiedere l'importazione dei dati di pagamento

Importare i dati di pagamento sensibili in modo sicuro

Stripe ti consente di conservare i dati esistenti relativi ai clienti e ai pagamenti quando esegui la migrazione a Stripe. Collaboriamo con il tuo team e con l’attuale fornitore di servizi di pagamento, se necessario, per migrare in modo sicuro le tue informazioni.

Questa procedura ti consente di accettare e addebitare importi a nuovi clienti su Stripe e di continuare ad addebitare gli importi ai clienti esistenti con l’attuale elaboratore fino al completamento della migrazione. I tuoi clienti non hanno tempi di inattività. Una volta completata la migrazione, puoi elaborare tutti i pagamenti su Stripe.

Questa guida ti spiega come migrare a Stripe da un altro elaboratore del pagamento o da una soluzione di pagamento personalizzata se sei un’azienda non enterprise (ad esempio una start-up o una piccola impresa). Potrai anche creare un’integrazione Stripe che potrai testare prima di attivare il servizio. Se hai domande sul processo di migrazione o sull’integrazione con Stripe, consulta la sezione Assistenza. Se non l’hai ancora fatto, consulta i prezzi di Stripe.

Prima di iniziare

Le attività devono richiedere assistenza al team Migrazioni dati di Stripe prima di eseguire la migrazione.
Se devi trasferire dati di pagamento sensibili, devi completare una richiesta di migrazione dati prima di eseguire la migrazione. Possiamo aiutarti in modo sicuro e conforme alle norme PCI.

Rivedi le funzioni di integrazione Stripe

Stripe semplifica i requisiti di sicurezza in modo che i clienti non debbano lasciare il tuo sito per completare un pagamento. Questa operazione viene eseguita tramite una combinazione di passaggi lato client e lato server:

Dal sito web in esecuzione sul browser del cliente, Stripe acquisisce in modo sicuro i dati di pagamento.
Stripe risponde con un token rappresentativo.
Il browser invia il token al tuo server, insieme a tutti gli altri dati del modulo.
Il codice lato server utilizza il token in una richiesta API, ad esempio durante la creazione di un addebito).

Questo approccio semplifica il flusso di pagamento sul tuo sito web e al tempo stesso i dati di pagamento sensibili non vengono mai trasmessi al tuo server. In questo modo puoi operare in conformità alle norme PCI, risparmiando tempo e offrendo vantaggi finanziari.

Flusso della procedura di pagamento di Stripe

Rispetto ad altri elaboratori di pagamento, un’integrazione Stripe si differenzia nei seguenti modi:

Il cliente non lascia mai il tuo sito web.
La creazione del token non è legata a un prodotto o a un importo specifico.
Non devi creare una chiave lato client su richiesta. Utilizza invece una determinata chiave API pubblicabile.

Crea un account Stripe

Prima di eseguire l’integrazione con Stripe, devi creare un account Stripe.

Crea un account inserendo indirizzo email, nome completo, Paese e creando una password.
Compila il profilo della tua attività.
Nella Dashboard, fai clic su Verifica la tua email. Stripe invia un’email di verifica al tuo indirizzo email.
Verifica il tuo indirizzo email.

Crea un'integrazione Stripe

Per tutti i nuovi token cliente (non importati), implementa quanto segue:

Utilizza gli oggetti Customer per salvare le informazioni della carta.
Raccogli e tokenizza le informazioni delle carte dei clienti con una delle nostre integrazioni di pagamento consigliate. Crea la tua integrazione Stripe prima di chiedere al tuo elaboratore del pagamento di trasferire i dati a Stripe. Per la maggior parte delle start-up, consigliamo di creare un’integrazione Embedded Checkout, un modulo di pagamento da integrare nel tuo sito web.
Per configurare questa integrazione, consulta la Guida rapida a Embedded Checkout e accetta pagamenti una tantum e pagamenti in abbonamento (se applicabile).
Crea addebiti per questi nuovi clienti.

Con questo approccio puoi accettare pagamenti dai nuovi clienti su Stripe senza ripercussioni sugli attuali clienti nell’elaboratore esistente durante la procedura di migrazione.

Considerazioni sull’integrazione

Progettare l’integrazione prima di chiedere all’elaboratore di pagamento di trasferire i dati a Stripe è il modo più efficiente per gestire i dati importati. Ecco alcune operazioni che puoi eseguire prima di richiedere un’importazione:

Associa di nuovo i record dei clienti
Proteggi gli aggiornamenti dei metodi di pagamento salvati durante la migrazione.
Abilita tutte le ottimizzazioni, come Adaptive Acceptance, l’utilità di aggiornamento carte (CAU) e i token di rete.

FacoltativoAssocia i clienti agli ID Stripe

Se preferisci, puoi configurare l’integrazione in modo da importare i dati relativi ai metodi di pagamento dai record precedenti negli oggetti Customer Stripe esistenti. In questo modo si evita che la migrazione crei un nuovo Customer (che potrebbe essere duplicato) nel tuo account Stripe per ogni ID cliente univoco presente nei file che riceviamo dal tuo precedente elaboratore.

Dopo la migrazione, potrebbe essere necessario aggiornare alcuni record in modo che corrispondano al nuovo identificativo cliente di Stripe se:

Hai creato Customer Stripe prima della migrazione, quindi abbiamo importato le informazioni di pagamento per aggiornare questo record Customer.
Abbiamo importato i dati di pagamento come nuovo record Customer.

Ad esempio, jenny.rosen@example.com cliente potrebbe avere l’ID 42 nel tuo database, corrispondente all’ID 1893 nel sistema dell’elaboratore precedente, ma è l’ID cus_12345 nel tuo account Stripe. In questo caso, devi associare il tuo ID 42 all’ID Stripe cus_12345 nel tuo database. Stripe fornisce un file di mappatura post-importazione per aiutarti a identificare la rimappatura necessaria.

FacoltativoProteggi gli aggiornamenti dei metodi di pagamento salvati

Se i clienti aggiornano i dati di pagamento con l’elaboratore precedente nella finestra compresa tra il trasferimento dei dati e il completamento dell’importazione, tali modifiche andranno perse.

Aggiorna la procedura del tuo sito per la gestione degli aggiornamenti dei pagamenti salvati, al fine di evitare errori o problemi di addebito per i tuoi clienti. Ciò include i preparativi per eseguire una migrazione autonoma per tutti i clienti che non dispongono di un ID Customer Stripe memorizzato:

Crea un nuovo oggetto Customer in Stripe per il tuo cliente.
Associa il metodo di pagamento all’oggetto Customer
Se necessario, esegui la migrazione degli abbonamenti.

Una volta completata la migrazione, Stripe gestisce automaticamente gli aggiornamenti attivati dalla carta, ad esempio le modifiche della data di scadenza.

Testa l'integrazione Stripe

Per testare l’integrazione del modulo di pagamento incorporato:

Crea una sessione di checkout incorporata e inserisci il modulo di pagamento nella tua pagina.
Compila i dettagli di pagamento con uno dei metodi indicati nella tabella di seguito.
- Inserisci una data di scadenza futura per la carta.
- Inserisci un numero di 3 cifre per il CVC.
- Inserisci un qualsiasi codice postale.
Fai clic su Paga. Ti reindirizzeremo al tuo return_url.
Accedi alla Dashboard e cerca il pagamento nella pagina Transazioni. Se il tuo pagamento è andato a buon fine, lo vedrai in quell’elenco.
Fai clic sul pagamento per visualizzare ulteriori dettagli, come il riepilogo di Checkout con i dati di addebito e l’elenco degli articoli acquistati. Puoi utilizzare queste informazioni per evadere l’ordine.

Scopri di più su come testare l’integrazione.

Numero di carta	Scenario	Come eseguire il test
	Il pagamento con carta ha esito positivo e non richiede l’autenticazione.	Compila il modulo della carta di credito utilizzando il numero di carta di credito con scadenza, CVC e codice postale.
	Il pagamento con carta richiede l’autenticazione.	Compila il modulo della carta di credito utilizzando il numero di carta di credito con scadenza, CVC e codice postale.
	La carta viene rifiutata con un codice di rifiuto del tipo `insufficient_funds`.	Compila il modulo della carta di credito utilizzando il numero di carta di credito con scadenza, CVC e codice postale.
	La carta UnionPay ha una lunghezza variabile di 13-19 cifre.	Compila il modulo della carta di credito utilizzando il numero di carta di credito con scadenza, CVC e codice postale.

Per ulteriori informazioni su come testare la tua integrazione, consulta la sezione Test.

Richiedi e conferma i dettagli della migrazione

Una volta completata l’integrazione ed è tutto pronto per elaborare i pagamenti su Stripe, richiedi i dati di pagamento all’elaboratore precedente. Molti elaboratori di pagamento richiedono che il titolare dell’account richieda il trasferimento dei dati.
Accedi al tuo account Stripe per inviare il modulo di richiesta di migrazione e richiedere l’importazione dei dati.
Interagisci con Stripe tramite lo thread email autenticato che creiamo una volta ricevuta la richiesta di migrazione.

Avviso

Non inviare mai i dati sensibili delle carte di credito o le informazioni sui clienti direttamente a Stripe. Se sei in possesso di questi dati, faccelo sapere compilando il modulo di richiesta per la migrazione in modo da poterti aiutare a trasferirli in modo sicuro.

Stripe può importare le informazioni relative all’indirizzo di addebito dei tuoi clienti e i dettagli di pagamento. Puoi anche:

Eseguire la migrazione di tipi di pagamento specifici
Eseguire la migrazione degli abbonamenti o importarli utilizzando il Toolkit per la migrazione di Billing.

Il tuo precedente elaboratore del pagamento potrebbe impiegare alcuni giorni o diverse settimane per trasferire i dati finali a Stripe. Tieni conto di questo tempo di transizione nel tuo piano di migrazione. Dopo che il tuo precedente elaboratore avrà trasferito i tuoi dati, Stripe li esaminerà e identificherà eventuali problemi con l’importazione. Collaboreremo con te e con il tuo precedente elaboratore per correggere eventuali problemi. Successivamente condivideremo un riepilogo dell’importazione per la revisione finale e approvazione e l’approvazione da parte tua.

Dopo la tua approvazione, Stripe importa i dati nel tuo account. Creiamo un oggetto Customer per ogni singolo cliente nel file dei dati trasferiti e creiamo e alleghiamo le carte del cliente come oggetti Card o Payment Method. Se i dati trasferiti specificano la carta predefinita del cliente, la impostiamo come metodo di pagamento predefinito del cliente per gli addebiti e i pagamenti degli abbonamenti.

Se al momento della migrazione il tuo account Stripe ha accumulato un numero significativo di record relativi ai clienti, valuta la possibilità di mappare i dati di importazione negli oggetti Customer Stripe esistenti invece di creare nuovi oggetti Customer.

Stripe in genere importa i dati entro 10 giorni lavorativi dalla ricezione dei dati corretti dall’elaboratore precedente, insieme a eventuali file di dati supplementari che vuoi condividere con il nostro team.

Aggiornare l'integrazione

Una volta completata l’importazione, Stripe ti invia un file CSV o JSON a scelta che mostra la relazione tra gli ID dell’attuale elaboratore e gli ID degli oggetti Stripe importati. Analizza questo file di mappatura e aggiorna il database di conseguenza. Assicurati che la tua integrazione gestisca tutti gli aggiornamenti delle carte avvenuti durante la transizione.

File di mappatura dopo l’importazione

Una volta aggiornata l’integrazione con questo file di mappatura, potrai iniziare ad addebitare gli importi a tutti i clienti su Stripe.

{
  "1893": {
    "cards": {
      "2600": {
        "id": "card_2222222222",
        "fingerprint": "x9yW1WE4nLvl6zjg",
        "last4": "4242",
        "exp_month": 1,
        "exp_year": 2020,
        "brand": "Visa"
      },
      "3520": {
        "id": "card_3333333333",
        "fingerprint": "nZnMWbJBurX3VHIN",
        "last4": "0341",
        "exp_month": 6,
        "exp_year": 2021,
        "brand": "Mastercard"
      }
    },
    "id": "cus_abc123def456"
  }
}

La mappatura JSON di esempio mostrata sopra:

Importato l’ID cliente 1893 come nuovo Customer Stripe con ID cus_abc123def456.
Importato ID carta cliente 2600 come nuova Card Stripe con ID card_2222222222.
Importato ID carta cliente 3520 come nuova Card Stripe con ID card_3333333333.

Stripe può importare i dati delle carte come PaymentMethods anziché come oggetti Card, se specificato nella richiesta di migrazione. Gli esempi seguenti mostrano i file di mappatura per diversi tipi di importazione delle informazioni di pagamento.

old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand
old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,424242,09,2024,Visa

Monitora i pagamenti importati

Dopo la migrazione, monitora le prestazioni dei pagamenti per assicurarti che il tasso di accettazione dei dati di pagamento importati corrisponda alle tue aspettative.

L’accettazione dei pagamenti (o tasso di autorizzazione della società emittente) è la percentuale di transazioni autorizzate dalla società emittente su tutte le transazioni inviate per il pagamento. Questa metrica esclude le transazioni bloccate (ad esempio a causa di regole Radar) perché non vengono mai inviate per l’autorizzazione.

Sia nell’approccio generale che dopo la migrazione, allinea gli obiettivi di ottimizzazione dell’autorizzazione dei pagamenti con quelli della tua attività. Ad esempio, un’attività che vende beni digitali a un costo unitario basso potrebbe impostare il proprio livello di rischio in modo da bloccare un numero inferiore di pagamenti. Considera i potenziali effetti:

Aumento dei tassi di conversione grazie alla riduzione delle complessità.
Aumento dell’esposizione alle frodi a causa dei pagamenti più rischiosi che vanno a buon fine.
Diminuzione dei tassi di autorizzazione grezzi delle società emittenti a causa dei blocchi dei modelli antifrode da parte della società emittente.

Assicurati di fornire dati accurati (come nome, indirizzo di addebito e email). Rispecchiare le intenzioni del titolare della carta massimizza le possibilità di autorizzazione.

Identificare le carte registrate

Le migrazioni dei dati di pagamento implicano carte registrate (carte salvate per un pagamento futuro dall’esercente o all’esterno della sessione per lo stesso cliente). Assicurati di memorizzare i dati di pagamento importati ed etichetta i pagamenti che utilizzano tali carte registrate con il parametro off_session corretto. Se identifichi in modo errato le carte registrate:

Le società emittenti che non possono confermare il consenso del titolare della carta per i pagamenti futuri o ricorrenti potrebbero rifiutarlo.
I dati di pagamento potrebbero non essere idonei per alcuni prodotti di ottimizzazione di Stripe, come l’utilità di aggiornamento carte e i token di circuito.

Monitorare i motivi di rifiuto per le opportunità di ottimizzazione

Dopo la migrazione, i motivi di rifiuto della società emittente possono aiutarti a capire se le transazioni dei dati di pagamento migrati sono quelle attese. I picchi in alcuni tipi di rifiuti potrebbero trarre vantaggio dai seguenti prodotti di ottimizzazione:

Utilità di aggiornamento carte: la partnership di Stripe con i circuiti delle carte di credito ci consente di ottenere automaticamente aggiornamenti per le carte scadute o sostituite sia in tempo reale che in background.
Nuovi tentativi automatici (sollecito): presta attenzione perché effettuare nuovi tentativi per numerose carte (ad esempio dopo una migrazione) potrebbe essere percepito come un’attività sospetta dalle società emittenti. Se utilizzi Smart Retries di Stripe per i pagamenti di Billing, il nostro modello di IA analizza i codici di rifiuto, gli aggiornamenti dei metodi di pagamento e l’attività della soglia di rischio bancario per ritentare i pagamenti con ricavi ricorrenti in modo più strategico.
Token di circuito: sostituisci un codice PAN (Payment Account Number) specifico con un token sicuro del circuito della carta per assicurarti che gli aggiornamenti del PAN (come il rinnovo o la sostituzione) si riflettano automaticamente nel token.
Adaptive acceptance: Stripe utilizza l’IA per valutare in tempo reale l’effetto di piccole rettifiche (come la formattazione) a una richiesta di autorizzazione, quindi perfeziona il tentativo di pagamento prima di restituire al cliente il rifiuto originale.
Comunicazioni con i clienti: chiedere al cliente di effettuare l’accesso e inserire o verificare nuovamente i propri dati di pagamento spesso ristabilisce l’affidabilità della tua attività presso il cliente e i fornitori di servizi di pagamento. Valuta la possibilità di inviare notifiche ai clienti tramite canali diversi dall’e-mail, ad esempio messaggi di testo o notifiche in-app.

La seguente tabella mostra quali prodotti di ottimizzazione offrono miglioramenti per una serie di motivi di rifiuto.

I codici di rifiuto possono includere	Effetto della migrazione	Cosa non fare	Cosa fare
`incorrect_number` `invalid_number` `expired_card`	Gli aggiornamenti ai dati della carta durante il ritardo naturale della migrazione possono causare l’obsolescenza dei dati delle carte salvati.	Utilità di aggiornamento carte Token di circuito Adaptive Acceptance Contatta il cliente	Riprova
`generic_decline` `do_not_honor`	Le modifiche alla voce per gli estratti conto o ad altri indicatori di identificazione potrebbero attivare modelli di rischio per le società emittenti o confondere il cliente.	Riprova Token di circuito Adaptive Acceptance Contatta il cliente	Utilità di aggiornamento carte
`transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc`	Per alcuni dati di pagamento migrati potrebbero mancare le informazioni iniziali di convalida della carta, come il token di circuito o l’ID transazione originale.	Utilità di aggiornamento carte Riprova Adaptive Acceptance Contatta il cliente	Token di circuito
`lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported`	I clienti potrebbero segnalare carte smarrite o rubate durante un ritardo della migrazione. Fai attenzione a un evento speciale CONTAC in concomitanza con questi rifiuti.	Token di circuito Contatta il cliente	Utilità di aggiornamento carte Riprova¹ Adaptive Acceptance

¹ La ripetizione di nuovi tentativi in caso di perdita o furto dei dati di pagamento può apparire sospetta alle società emittenti delle carte.

FacoltativoEsegui la migrazione degli abbonamenti

Le migrazioni che coinvolgono abbonamenti prevedono in genere le seguenti fasi:

Configurare l’integrazione per gli addebiti.
Eseguire la migrazione delle informazioni relative ai clienti e all’elaboratore di pagamento.
Importa i tuoi abbonamenti in Stripe Billing.
È possibile importare gli abbonamenti esistenti utilizzando l’API Subscriptions o il Toolkit di migrazione di Billing della Dashboard.
Una volta lasciato l’elaboratore di pagamento, verifica che abbia annullato tutti gli addebiti automatici dei tuoi clienti.

Chiave PGP di migrazione

Se non hai familiarità con PGP, visita la pagina dedicata a GPG e inizia a importare una chiave pubblica. Dopo aver acquisito dimestichezza con le nozioni di base di PGP, utilizza la seguente chiave PGP in modo da crittografare i dati sensibili (come i dati della carta di credito) per la migrazione conforme alle PCI.

Chiave di migrazione PGP

Viene creato il file NOMEFILE.gpg con le seguenti informazioni:

ID chiave: 9C78B7620C1E99AD
Tipo di chiave: RSA
Dimensione chiave: 4096 bits
Impronta: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
Id utente: Stripe Import Key (PCI) <support-migrations@stripe.com>

Una volta importata la nostra chiave, puoi crittografare i file da inviare eseguendo questo comando nel prompt della riga di comando:

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

Per ulteriori informazioni sulla fornitura di dati crittografati a Stripe, consulta Caricare informazioni supplementari.