Accettare un pagamento Klarna
Scopri come accettare un pagamento con Klarna, una modalità di pagamento a rate utilizzata in tutto il mondo.
Voci riga unificate con Klarna
Per ottimizzare i tassi di approvazione durante l’integrazione con Klarna, includi dati line_
per rappresentare il contenuto del carrello di un acquirente. Per l’accesso anticipato, consulta le voci riga di Payments.
Quando un cliente accetta Klarna nella tua app, viene visualizzata una vista web con cui il cliente deve autenticare il proprio pagamento. Il cliente torna quindi alla tua app e tu puoi verificare immediatamente se il pagamento ha avuto esito positivo o negativo.
Nota
Prima di avviare l’integrazione, assicurati che il tuo account sia idoneo per Klarna accedendo alle impostazioni delle modalità di pagamento.
Configura StripeLato serverLato client
Innanzitutto, devi creare un account Stripe. Registrati ora.
Lato server
Per questa integrazione sono necessari endpoint sul server che comunicano con l’API Stripe. Utilizza le nostre librerie ufficiali per accedere all’API Stripe dal tuo server:
Lato client
L’SDK per iOS di Stripe è open source, completamente documentato e compatibile con le app che supportano iOS 13 o versioni successive.
Nota
Per ulteriori informazioni sulla versione più recente e su quelle precedenti dell’SDK, consulta la pagina Versioni su GitHub. Per ricevere notifiche quando viene pubblicata una nuova versione, guarda le versioni del repository.
Configura l’SDK con la tua chiave pubblicabile di Stripe all’avvio dell’app. In questo modo l’app può inviare le richieste all’API Stripe.
Nota
Usa le chiavi di test durante i test e le chiavi della modalità live quando pubblichi l’app.
Creare un PaymentIntentLato serverLato client
Un PaymentIntent è un oggetto che rappresenta la tua intenzione di riscuotere un pagamento da un cliente e traccia il ciclo di vita del processo di pagamento in ogni sua fase.
Lato server
Innanzitutto crea un PaymentIntent
sul tuo server e specifica l’importo da riscuotere e la valuta. Se hai già un’integrazione che utilizza l’API Payment Intents, aggiungi klarna
all’elenco dei tipi di metodi di pagamento per il tuo PaymentIntent
.
Lato client
Nel PaymentIntent restituito è presente una chiave privata client, che il client può utilizzare per completare la procedura di pagamento in modo sicuro anziché specificare tutto l’oggetto PaymentIntent. Sul lato client, richiedi un PaymentIntent dal tuo server e memorizza la chiave privata client.
Inviare il pagamento a StripeLato client
Recupera la chiave privata client dal PaymentIntent che hai creato nel passaggio 2 e chiama il metodo STPPaymentHandler confirmPayment:. Verrà visualizzata una vista web dove il cliente potrà completare il pagamento, che a sua volta avvia una chiamata al blocco di completamento con il risultato del pagamento.
Eseguire il test dell'integrazione Klarna
Di seguito abbiamo selezionato dati di test per i Paesi attualmente supportati. In una sandbox, Klarna approva o rifiuta una transazione in base all’indirizzo email fornito.
Autenticazione a due fattori
Qualsiasi numero a sei cifre è un codice valido per l’autenticazione a due fattori. Utilizza 999999
per la mancata autenticazione.
Modalità di rimborso
Nel flusso di Klarna in modalità di test, puoi utilizzare i seguenti valori di test per provare i diversi tipi di rimborso:
Tipo | Valore |
---|---|
Addebito diretto | DE11520513735120710131 |
Bonifico bancario | Banca demo |
Carta di credito |
|
Carta di debito |
|
Pagamenti non riusciti
Klarna decide se accettare o rifiutare una transazione in base a diversi fattori, ad esempio da quanto tempo l’acquirente utilizza Klarna, l’importo in sospeso che il cliente deve rimborsare o il valore dell’ordine corrente.
Quando il cliente seleziona un metodo di pagamento a rate, Klarna esegue una valutazione del rischio prima di accettare la transazione. A seconda del risultato della valutazione, dell’importo della transazione o del debito residuo del cliente, Klarna potrebbe rifiutare la transazione. Pertanto ti consigliamo di inserire altre opzioni di pagamento nel flusso di completamento della transazione, come ad esempio card
. In questi casi, il PaymentMethod viene scollegato e lo stato dell’oggetto PaymentIntent diventa automaticamente a requires_
.
I clienti devono completare il pagamento entro 48 ore dal reindirizzamento al sito Klarna. Se non viene intrapresa alcuna azione dopo 48 ore, l’oggetto PaymentMethod viene scollegato e lo stato dell’oggetto PaymentIntent passa automaticamente da requires_
a requires_
.
In questi casi, invita il cliente a riprovare con una diversa opzione di pagamento presente nel tuo flusso di completamento della transazione.
Limiti di frequenza di Klarna
Le richieste API indirizzate a Klarna sono soggette a limiti di frequenza oltre ai limiti di frequenza a livello dell’API di Stripe. Questi limiti possono variare a seconda della forma delle richieste API effettuate. In generale, se effettui più di 360 richieste al minuto, potresti riscontrare una certa limitazione della velocità sotto forma di risposte con codice di stato HTTP 400
o 402
. Contattaci per ulteriori informazioni se temi che il tuo utilizzo possa raggiungere questi livelli, poiché Klarna potrebbe essere in grado di aumentare questi limiti caso per caso.
Messaggi di errore
In genere i pagamenti Klarna non riusciti restituiscono uno dei seguenti codici di errore. Questi codici vengono visualizzati nell’oggetto API last_payment_error.
Attenzione
Prima della versione API 2023-08-16
, tutti gli errori di Klarna venivano segnalati come payment_intent_authentication_failure. Verifica che la tua versione dell’API sia aggiornata per visualizzare gli errori dettagliati elencati di seguito.
Codice di errore | Spiegazione |
---|---|
payment_method_customer_decline | Il cliente ha annullato il pagamento sulla pagina di Klarna |
payment_method_provider_decline | Klarna ha rifiutato il pagamento del cliente |
payment_intent_payment_attempt_expired | Il cliente non ha mai completato il pagamento sulla pagina di Klarna e la sessione di pagamento è scaduta |
payment_method_not_available | Si è verificato un errore imprevisto durante il tentativo di utilizzare Klarna |