Metti alla prova la tua integrazione con Stripe
Scopri i diversi metodi per testare l'integrazione con Stripe prima di avviarla.
NON È UNO SVILUPPATORE?
Assumi un esperto certificato qui puoi farlo da solo oppure utilizzare una soluzione predefinita creata da uno dei nostri partner verificati (non è richiesto alcun codice).
Questa pagina include i numeri delle schede di prova e altre informazioni per garantire che l'integrazione funzioni come previsto. Utilizzala per attivare diversi flussi nella tua integrazione e assicurarti che vengano gestiti di conseguenza.
API di intenzione di pagamento
Quando si utilizza l'API Payment Intent con le librerie client e gli SDK di Stripe, assicurarsi che:
- I flussi di autenticazione vengono attivati quando necessario (utilizzare i numeri di carta di prova e i metodi di pagamento normativi).
- Senza autenticazione (carta USA predefinita): 4242 4242 4242 4242.
- Autenticazione richiesta: 4000 0027 6000 3184.
- Il tentativo di pagamento viene creato con una chiave di chiave di idempotenza per evitare la creazione errata di tentativi di pagamento duplicati per lo stesso acquisto.
- Gli errori vengono rilevati e visualizzati correttamente nell'interfaccia utente.
API di addebito
Quando si utilizza l' API Charges con le librerie client e gli SDK di Stripe, assicurarsi che:
- L'elemento card è stato trasmesso correttamente per creare il token nel controller di invio.
- Nel controller di risposta per la creazione del token, gli errori della carta vengono gestiti e visualizzati correttamente.
- Solo i token validi vengono trasmessi al tuo server come parte dell'invio del modulo di pagamento.
Codice lato server
Nel codice lato server, assicurati che:
- Tutte le richieste vengono elaborate correttamente. Potrebbe esserti utile visualizzare gli eventi e i registri del tuo account durante il test dell'integrazione.
- Tutti gli errori API vengono gestiti correttamente.
- I webhook pertinenti vengono gestiti correttamente.
- Quando sei pronto a pubblicare la tua integrazione, sostituisci il segreto di test e le chiavi API pubblicabili con le chiavi live. I pagamenti live non possono essere elaborati se l'integrazione utilizza ancora le chiavi di test.
Numeri di base delle schede di prova
I dati della carta originale non possono essere utilizzati in modalità di prova. Utilizza invece uno dei seguenti numeri di carta di prova, una data di scadenza futura valida e un codice CVC casuale per effettuare un pagamento. Il Paese di fatturazione per ogni carta di prova di base è impostato sugli Stati Uniti. Se devi effettuare pagamenti con carta di prova con carte di altri Paesi di fatturazione, utilizza le nostre carte di prova internazionali.
|
Numero |
Brand |
CVC |
Data |
|---|---|---|---|
|
|
Visa | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Visa (debito) | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
MasterCard | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Mastercard (serie 2) | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Mastercard (debito) | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Mastercard (prepagata) | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
American Express | Qualsiasi 4 cifre | Qualsiasi data futura |
|
|
American Express | Qualsiasi 4 cifre | Qualsiasi data futura |
|
|
Scopri | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Scopri | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Diners Club | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
Diners Club (carta a 14 cifre) | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
JCB | qualsiasi numero di 3 cifre | Qualsiasi data futura |
|
|
UnionPay | qualsiasi numero di 3 cifre | Qualsiasi data futura |
Ti consigliamo di utilizzare i nostri ID di test quando testi la tua integrazione e crei addebiti, anziché passare direttamente le informazioni della carta all'API. L'utilizzo di questi ID di test al posto dei numeri di carta aiuta a garantire che l'integrazione di produzione sia conforme allo standard PCI e non gestisca direttamente le informazioni della carta. Ogni ID di test è leggibile e rappresenta le informazioni della carta che sono state tokenizzate utilizzando le nostre librerie lato client (ad esempio, Stripe Elements, Stripe.js).
Numeri delle carte di prova internazionali
È possibile utilizzare una qualsiasi delle seguenti carte di prova per simulare un pagamento riuscito per diversi Paesi di fatturazione.
|
Numero |
Token |
Metodo di pagamento |
Paese |
Brand |
|---|---|---|---|---|
|
|
tok_us |
pm_card_us |
Stati Uniti (US) | Visa |
|
|
tok_br |
pm_card_br |
Brasile (BR) | Visa |
|
|
tok_ca |
pm_card_ca |
Canada (CA) | Visa |
|
|
tok_mx |
pm_card_mx |
Messico (MX) | Visa |
Numeri di carte di prova regolamentari (3D Secure)
Le seguenti informazioni sulla carta consentono di testare i pagamenti soggetti a normative regionali, come la Strong Customer Authentication (SCA). Utilizzale per testare le carte risparmio con l'API Setup Intents.
|
Numero |
Descrizione |
|---|---|
|
|
Questa carta richiede l'autenticazione per pagamenti una tantum. Tuttavia, se tu Imposta questa carta e utilizzare la carta salvata per i successivi pagamenti fuori sessione, senza bisogno di ulteriori autenticazioni. |
|
|
Questa carta richiede l'autenticazione per tutte le transazioni, indipendentemente dalla configurazione della carta. |
|
|
Questa carta richiede l'autenticazione per pagamenti una tantumTutti i pagamenti saranno rifiutati con un insufficient_funds codice di errore anche dopo essere stati autenticati correttamente o in precedenza impostare. |
|
|
Questa carta richiede l'autenticazione per Una volta e altro in sessione pagamenti. Tuttavia, tutti pagamenti fuori sessione avrà successo come se la carta fosse stata precedentemente impostare. |
Numeri e token delle carte di prova 3D Secure
Non tutte le carte supportano 3D Secure o richiedono il reindirizzamento del cliente alla pagina di autenticazione dell'emittente della carta. Utilizza le informazioni della carta qui sotto per testare i pagamenti 3D Secure; tieni presente che i reindirizzamenti 3D Secure non verranno eseguiti per i pagamenti creati direttamente nella Dashboard di Stripe.
|
Numero |
Utilizzo di 3D Secure |
Descrizione |
|---|---|---|
|
|
Obbligatorio | Affinché il pagamento vada a buon fine, è necessario completare l'autenticazione 3D Secure 2. Per impostazione predefinita, le regole Radar richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Obbligatorio | Affinché il pagamento vada a buon fine, è necessario completare l'autenticazione 3D Secure. Per impostazione predefinita, le regole Radar richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Obbligatorio | È richiesta l'autenticazione 3D Secure, ma i pagamenti verranno rifiutati con un card_declined Codice di errore dopo l'autenticazione. Per impostazione predefinita, le regole Radar richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Obbligatorio | È richiesta l'autenticazione 3D Secure, ma la richiesta di ricerca 3D Secure fallirà con un errore di elaborazione. I pagamenti verranno rifiutati con un card_declined codice di errore. Per impostazione predefinita, le regole Radar richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Supporto | L'autenticazione 3D Secure può comunque essere eseguita, ma non è obbligatoria. Per impostazione predefinita, le regole Radar non richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Supporto | L'autenticazione 3D Secure può comunque essere eseguita, ma non è obbligatoria. Tuttavia, i tentativi di eseguire l'autenticazione 3D Secure generano un errore di elaborazione. Per impostazione predefinita, le regole Radar non richiederanno l'autenticazione 3D Secure per questa carta. |
|
|
Supporto | Questa carta supporta il protocollo 3D Secure, ma non è registrata al protocollo 3D Secure. Ciò significa che se le tue regole Radar richiedono il protocollo 3D Secure, il cliente non dovrà effettuare alcuna autenticazione aggiuntiva. Per impostazione predefinita, le tue regole Radar non richiedono l'autenticazione 3D Secure per questa carta. |
|
|
Non supportato | 3D Secure non è supportato su questa carta e non può essere attivato. PaymentIntent procederà senza eseguire l'autenticazione. |
Tutte le altre carte di prova Visa e Mastercard non richiedono l'autenticazione da parte dell'emittente della carta del cliente.
Testare risposte ed errori specifici
È possibile utilizzare le seguenti schede di test per creare pagamenti che generano risposte specifiche, utili per testare diversi scenari e codici di errore. I controlli di verifica vengono eseguiti solo quando vengono fornite le informazioni richieste (ad esempio, è necessario fornire un codice CVC affinché il verificatore CVC venga impostato su "fallito").
|
Numero |
Descrizione |
|---|---|
|
|
L'addebito va a buon fine e i fondi verranno aggiunti direttamente al saldo disponibile (ignorando il saldo in sospeso). |
|
|
L'addebito va a buon fine e i fondi verranno aggiunti direttamente al saldo disponibile (ignorando il saldo in sospeso). |
|
|
L'addebito va a buon fine e viene applicato il prezzo nazionale (altre carte di prova utilizzano il prezzo internazionale). Questa carta è rilevante solo nei paesi con prezzi differenziati. |
|
|
Migliori address_line1_check and address_zip_check le verifiche falliscono. Se il tuo account è bloccare i pagamenti che non superano la convalida del codice postaleL'addebito viene rifiutato. |
|
|
La carica riesce ma il address_line1_check La verifica non riesce. |
|
|
Migliori address_zip_check la verifica fallisce. Se il tuo account è bloccare i pagamenti che non superano la convalida del codice postaleL'addebito viene rifiutato. |
|
|
La carica riesce ma il address_zip_check and address_line1_check le verifiche sono entrambe unavailable. |
|
|
La carica riesce ma il rimborso di un addebito acquisito non riesce in modo asincrono con un failure_reason of expired_or_canceled_cardSi noti che poiché i fallimenti dei rimborsi sono asincroni, il rimborso sembrerà inizialmente riuscito e avrà solo il failed stato sui recuperi successivi. Ti informiamo anche dei fallimenti di rimborso utilizzando il charge.refund.updated webhook evento. |
|
|
L'addebito ha esito positivo ma i rimborsi vengono inizialmente trattenuti nel pending stato. Qualche tempo dopo il rimborso viene sbloccato e viene inviato un charge.refund.updated webhook evento. |
|
|
Se viene fornito un numero CVC, il cvc_check fallisce. Se il tuo account è bloccare i pagamenti che non superano la convalida del codice CVCL'addebito viene rifiutato. |
|
|
Allegando questa carta a un l'oggetto riesce, ma i tentativi di addebitare l'importo al cliente falliscono. |
|
|
Risulta in una carica con un risk_level of elevata. |
|
|
Risulta in una carica con un risk_level of massimo. |
|
|
Risulta in una carica con un risk_level of massimoL'addebito è bloccato perché ritenuto fraudolento. |
|
|
L'addebito viene rifiutato con un card_declined codice. |
|
|
L'addebito viene rifiutato con un card_declined codice. Il codice_rifiuto l'attributo è insufficient_funds. |
|
|
L'addebito viene rifiutato con un card_declined codice. Il codice_rifiuto l'attributo è lost_card. |
|
|
L'addebito viene rifiutato con un card_declined codice. Il codice_rifiuto l'attributo è stolen_card. |
|
|
L'addebito viene rifiutato con un expired_card codice. |
|
|
L'addebito viene rifiutato con un incorrect_cvc codice. |
|
|
L'addebito viene rifiutato con un processing_error codice. |
|
|
L'addebito viene rifiutato con un incorrect_number codice come il numero della carta non riesce Controllo Luhn. |
|
|
La carica ha esito positivo e restituisce un brand_product of MWE. |
Per impostazione predefinita, l'inclusione dei dati relativi all'indirizzo o al CVC insieme al numero di carta garantisce il successo dei controlli relativi all'indirizzo e al CVC. Se queste informazioni non vengono specificate, i controlli non saranno validi. Qualsiasi data di scadenza futura sarà considerata valida.
È anche possibile fornire dettagli sulle carte non valide per verificare la presenza di codici di errore specifici derivanti da informazioni errate. Ad esempio:
- invalid_expiry_month: utilizza un mese non valido (ad esempio, 13)
- invalid_expiry_year: utilizzare un anno nel passato (ad esempio, 1970)
- invalid_cvc: utilizzare un numero a due cifre (ad esempio, 99)
Numeri delle carte di prova di Cartes Bancaires
In modalità test, puoi utilizzare le carte di prova sottostanti per simulare un addebito su Cartes Bancaires:
|
Numero |
Descrizione |
|---|---|
|
|
Crea un metodo di pagamento tramite carta Cartes Bancaires in co-branding con Visa. |
|
|
Crea un metodo di pagamento tramite carta Cartes Bancaires in co-branding con Mastercard. |
controversie
In modalità test, puoi utilizzare le seguenti carte di prova per simulare una transazione contestata:
Invia uno qualsiasi dei seguenti valori di testo non categorizzati per dimostrare l'esito positivo o negativo di una controversia:
|
Prova |
Descrizione |
|---|---|
winning_evidence |
La controversia viene chiusa e contrassegnata come vinta. L'importo dell'addebito e delle relative commissioni viene accreditato sul tuo conto. |
losing_evidence |
La controversia è chiusa e contrassegnata come persa. Il tuo account non è stato accreditato. |
È possibile utilizzare questi valori anche per verificare i risultati delle contestazioni nella dashboard . Inserire uno di questi valori nel campo Informazioni aggiuntive durante l'invio delle prove, quindi fare clic su Invia prove.
Collegamento con Stripe
Puoi creare account di prova per Link con Stripe utilizzando qualsiasi indirizzo email valido. Puoi utilizzare codici di accesso fissi e monouso per autenticare gli account di prova, come descritto di seguito:
|
Valore |
Risultato |
|---|---|
| Altre 6 cifre non elencate di seguito | L'autenticazione è riuscita. |
| 000001 | L'autenticazione non riesce perché il codice di accesso monouso non è valido. |
| 000002 | L'autenticazione non riesce perché il codice di accesso monouso è scaduto. |
| 000003 | L'autenticazione non riesce perché è stato superato il numero massimo di tentativi. |
Limiti tariffari
È altamente improbabile che gli utenti riscontrino limiti di velocità con un utilizzo normale dell'API, anche a volumi elevati. Le cause più comuni dei limiti di velocità sono errori, recuperi di dati di grandi dimensioni o test di carico estremi.
Se le tue richieste iniziano a ricevere errori HTTP 429, riducine la frequenza. È sicuro riprovare ogni richiesta non riuscita, poiché la limitazione della velocità interviene prima di qualsiasi altra azione e impedisce l'elaborazione della richiesta. Quando riduci la frequenza delle richieste, ti consigliamo di applicare un backoff esponenziale, attendendo un secondo prima di riprovare. Se la richiesta continua a ricevere la stessa risposta, attendi due secondi, poi quattro secondi e così via.
Il limite di frequenza in modalità test è inferiore a quello in modalità live. Se hai dei limiti tariffari ma non riesci a determinarne il motivo, ti preghiamo di comunicarcelo.
Fonti
Utilizzare le seguenti informazioni quando si testano i pagamenti tramite le fonti.
Reindirizzare le fonti
Creando un oggetto sorgente di prova che utilizza un flusso di reindirizzamento (ad esempio, iDEAL), puoi seguire l'URL restituito nel campo di reindirizzamento [url]. Questo porta a una pagina Stripe che mostra informazioni sulla richiesta API e dove puoi autorizzare o annullare il pagamento.
Dopo aver autorizzato il pagamento, verrai reindirizzato all'URL specificato nel reindirizzamento [return_url].
Addebito diretto BECS in Australia
È possibile creare un PaymentIntent di prova che abbia esito positivo o negativo procedendo come segue:
Crea un metodo di pagamento di prova utilizzando il codice BSB 000-000 e un numero di conto di prova dall'elenco sottostante.
Utilizzare il PaymentMethod risultante in una richiesta confirmAuBecsDebitPayment per creare l'addebito di prova.
Numeri di prova dell'account
|
Numero di conto |
Descrizione |
|---|---|
000123456 |
Lo stato di PaymentIntent passa da processing a succeededLo stato del mandato rimane active. |
900123456 |
Lo stato di PaymentIntent passa da processing a succeeded (con un ritardo di tre minuti). Lo stato del mandato rimane active. |
111111113 |
Lo stato di PaymentIntent passa da processing a requires_payment_method con account_closed codice di errore. Lo stato del mandato diventerà inactive. |
111111116 |
Lo stato di PaymentIntent passa da processing a requires_payment_method con una no_account codice di errore. Lo stato del mandato diventerà inactive. |
222222227 |
Lo stato di PaymentIntent passa da processing a requires_payment_method con una refer_to_customer codice di errore. Lo stato del mandato rimarrà active. |
922222227 |
Lo stato di PaymentIntent passa da processing a requires_payment_method con una refer_to_customer codice di errore (con un ritardo di tre minuti). Lo stato del mandato rimarrà active. |
333333335 |
Lo stato di PaymentIntent passa da processing a requires_payment_method con una debit_not_authorized codice di errore. Lo stato del mandato diventerà inactive. |
Webhooks
Consultare Webhook per informazioni su come installare e configurare un endpoint.
Per testare l'integrazione, esegui azioni utilizzando l'API (in modalità test) per inviare eventi legittimi al tuo endpoint. Ad esempio, la creazione di un addebito attiva l'evento `charge.succeeded`, che contiene i dati dell'addebito. Puoi facilmente attivare eventi utilizzando la CLI di Stripe o Stripe per Visual Studio Code. Puoi quindi utilizzare l'API per verificare i dati dell'evento risultanti. Se stai migrando all'API Payment Intent, consulta anche Monitoraggio di un Payment Intent con Webhook.
Puoi anche inviare eventi di test al tuo endpoint di integrazione tramite le impostazioni dei webhook del tuo account. Tuttavia, i dati degli eventi contenuti in questi eventi sono fittizi e non disponibili nell'API; il loro scopo è esclusivamente quello di verificare che l'endpoint funzioni e sia configurato correttamente.
[hover_color align=»center» background=»» background_hover=»» border=»» border_hover=»» border_width=»0px» padding=»60px 60px» link=»https://selfish.com.mx/servicios/» target=»» class=»cta-blog themecolorbg» style=»»] Pronto a portare il tuo e-commerce a un altro livello? [/hover_color]
