Vai al contenuto principale
Integrazione

Integrazione Redsys

Integriamo Redsys, il gateway di pagamento dominante in Spagna, nella tua piattaforma web o app. API REST, tokenizzazione per addebiti ricorrenti, 3D Secure 2.0, POS virtuale, Bizum e gestione completa degli ambienti di test.

Il gateway leader in Spagna

Redsys elabora la stragrande maggioranza dei pagamenti con carta in Spagna

Redsys è l'infrastruttura di elaborazione dei pagamenti utilizzata dalla maggior parte delle banche spagnole: CaixaBank, BBVA, Santander, Sabadell, Bankinter e molte altre. Quando un merchant spagnolo accetta pagamenti con carta, nella stragrande maggioranza dei casi la transazione passa da Redsys. Questo lo rende il gateway di pagamento più importante del mercato spagnolo, con i migliori tassi di accettazione per le carte emesse dalle banche nazionali e le commissioni più competitive disponibili.

A differenza dei gateway internazionali come Stripe o Adyen, Redsys non è una piattaforma di pagamento all-in-one. È specificamente un processore di pagamenti che collega il tuo conto merchant alla rete bancaria spagnola. Questo comporta vantaggi e svantaggi: le commissioni sono in genere più basse perché la tua banca acquirer negozia le tariffe direttamente con te, e i tassi di accettazione per le carte spagnole sono più alti. Ma l'integrazione tecnica è più complessa, la documentazione è storicamente limitata e funzionalità come abbonamenti o pagamenti marketplace richiedono un'implementazione manuale.

Se sei un'azienda internazionale che vuole vendere in Spagna, capire Redsys è importante perché è il modo in cui la maggior parte dei consumatori spagnoli paga online. Sebbene Stripe funzioni in Spagna, le transazioni instradate tramite Redsys attraverso una banca locale hanno spesso tassi di accettazione più alti e commissioni più basse per le carte emesse in Spagna. Per le aziende che puntano principalmente al mercato spagnolo, l'integrazione di Redsys può migliorare sensibilmente i tassi di conversione e ridurre i costi di elaborazione dei pagamenti rispetto all'uso esclusivo di un gateway internazionale.

La API di Redsys si è evoluta molto negli ultimi anni. La moderna API REST sostituisce il classico sistema di form con redirect, permettendo un'integrazione molto più flessibile. La tokenizzazione delle carte consente addebiti ricorrenti senza memorizzare dati sensibili. Il 3D Secure 2.0 con autenticazione adattiva riduce la frizione al checkout. E l'integrazione di Bizum come metodo di pagamento permette agli utenti di pagare direttamente dalla loro app bancaria con un solo tap, raggiungendo tassi di conversione superiori al 90% con il pubblico spagnolo.

90%+

Banche spagnole

3DS2

3D Secure 2.0

Bizum

Pagamento mobile

Token

Addebiti ricorrenti

Funzionalità

Cosa integriamo con Redsys

Tutte le funzionalità del gateway, implementate correttamente e secondo le best practice.

REST API

Integrazione con la moderna API REST di Redsys (InSite / REST JSON). Firma delle richieste con HMAC SHA256 e chiave di cifratura del merchant. Gestione corretta dei flussi di autorizzazione, conferma e notifica (URL OK, KO e di notifica). Parsing e validazione delle risposte. Gestione dei diversi stati delle transazioni e dei codici di errore per fornire un feedback preciso all'utente.

Tokenizzazione

Tokenizzazione delle carte per addebiti ricorrenti (COF - Credential on File). Archiviazione sicura dei token Redsys senza salvare i dati delle carte nel tuo sistema. MIT (Merchant Initiated Transactions) per addebiti senza intervento dell'utente. CIT (Cardholder Initiated Transactions) per addebiti autenticati. Gestione del ciclo di vita dei token: creazione, utilizzo e revoca. Conformità PCI DSS a livello SAQ-A.

3D Secure 2.0

Implementazione del 3D Secure 2.0 conforme alla direttiva PSD2/SCA. Invio di dati di autenticazione arricchiti (indirizzo di spedizione, storico del cliente, dispositivo) per massimizzare le approvazioni frictionless. Gestione del flusso challenge quando l'issuer richiede un'autenticazione aggiuntiva. Esenzioni SCA configurabili: transazioni a basso rischio (TRA), importi ridotti, merchant di fiducia (whitelisting). Fallback al 3DS 1.0 quando l'issuer non supporta il 2.0.

Bizum

Integrazione di Bizum come metodo di pagamento all'interno del flusso Redsys. Gli utenti inseriscono il numero di telefono e confermano il pagamento dalla loro app bancaria. Tassi di conversione superiori al 90% con il pubblico spagnolo. Configurazione del POS virtuale per accettare Bizum insieme ai pagamenti con carta. Notifiche di pagamento in tempo reale. Essenziale per le aziende che si rivolgono ai consumatori spagnoli e vogliono massimizzare la conversione.

POS virtuale

Configurazione e gestione del terminale POS virtuale nel pannello di amministrazione di Redsys. Registrazione del merchant, impostazione delle valute accettate, URL di ritorno, URL di notifica e metodi di pagamento abilitati. Gestione multi-merchant quando la tua azienda opera con entità o brand diversi. Personalizzazione della pagina di pagamento ospitata su Redsys con i colori e il logo del tuo brand. Configurazione di limiti e restrizioni per tipo di operazione.

Testing ed errori

Configurazione dell'ambiente di test sandbox SIS-T di Redsys per lo sviluppo. Carte di test per simulare diversi scenari: pagamento riuscito, rifiutato, timeout, 3D Secure. Mappatura completa dei codici di errore Redsys (DSxxxx, SISxxxx) in messaggi comprensibili per l'utente. Log dettagliato delle transazioni per il debugging. Monitoraggio del tasso di errore e alert automatici quando vengono rilevati pattern anomali.

Devi integrare Redsys nel tuo progetto?

Consulenza gratuita →
Confronto

Redsys vs Stripe: quando usare ciascuno

Non è sempre una scelta esclusiva. In molti progetti l'approccio migliore è combinare entrambi i gateway.

Scegli Redsys quando...

  • Il tuo pubblico principale è spagnolo e vuoi le migliori commissioni con la tua banca
  • Hai bisogno di accettare Bizum come metodo di pagamento
  • La tua banca offre commissioni negoziate molto competitive
  • Operi in un settore dove i tassi di accettazione delle carte spagnole sono critici
  • Vuoi massimizzare la fiducia degli utenti spagnoli con la pagina di pagamento della loro banca

Scegli Stripe quando...

  • Vendi a livello internazionale e ti servono multivaluta e metodi di pagamento globali
  • Hai bisogno di abbonamenti con billing avanzato (proration, dunning, metering)
  • Gestisci un marketplace e ti servono pagamenti split (Stripe Connect)
  • Dai priorità alla developer experience e alla qualità della documentazione
  • Ti serve una prevenzione frodi avanzata basata su ML (Stripe Radar)
Tecnologie

Stack tecnologico Redsys

Redsys REST API Redsys InSite HMAC SHA256 Node.js TypeScript Python PHP PostgreSQL Redis Webhooks React Next.js Docker AWS 3D Secure 2.0 PCI DSS SAQ-A
FAQ

Domande frequenti sull'integrazione di Redsys

Come si registra un merchant su Redsys?
La registrazione del merchant su Redsys si gestisce tramite la tua banca acquirer (CaixaBank, BBVA, Santander, ecc.). Richiedi un POS virtuale alla banca, firmi il contratto e-commerce e ricevi le credenziali: numero merchant (FUC), numero di terminale e chiave di cifratura. Il processo richiede in genere 1-3 settimane a seconda della banca. Noi ci occupiamo della parte tecnica una volta ottenute le credenziali: configurazione del POS, integrazione della API, test in sandbox e deployment in produzione.
Redsys si può usare per addebiti ricorrenti e abbonamenti?
Sì, tramite la tokenizzazione COF (Credential on File). Alla prima transazione con autenticazione 3D Secure, Redsys restituisce un token che identifica la carta del cliente. Questo token viene salvato in modo sicuro e usato per gli addebiti successivi (MIT - Merchant Initiated Transactions) senza intervento dell'utente. La differenza rispetto a Stripe Billing è che con Redsys devi costruire tu la logica degli abbonamenti (quando addebitare, retry, proration), mentre Stripe la gestisce out-of-the-box.
Cos'è Bizum e perché è importante per la Spagna?
Bizum è il sistema di pagamento mobile più popolare in Spagna, con oltre 25 milioni di utenti: un dato notevole considerando che la Spagna conta circa 47 milioni di abitanti. Permette pagamenti istantanei direttamente dalle app bancarie usando solo il numero di telefono. Nell'e-commerce, Bizum raggiunge tassi di conversione superiori al 90% con il pubblico spagnolo perché non serve inserire i dati della carta. Si integra tramite Redsys come metodo di pagamento aggiuntivo. Per qualsiasi azienda che si rivolge ai consumatori spagnoli, Bizum è essenziale quanto Apple Pay o Google Pay.
Quali sono gli errori più comuni nell'integrazione di Redsys?
Gli errori più comuni sono: firma della richiesta errata (errore SIS0042) per problemi di codifica Base64 o di ordine dei parametri, URL di notifica non raggiungibile dai server Redsys (deve essere pubblico, non localhost), confusione tra ambiente di test (sis-t.redsys.es) e produzione (sis.redsys.es) e gestione errata del flusso 3D Secure che porta a transazioni rifiutate. Anche se la documentazione di Redsys è migliorata, presenta ancora lacune che si risolvono al meglio con l'esperienza pratica.
Quanto costa un'integrazione Redsys?
Un'integrazione Redsys standard con checkout a redirect, 3D Secure e notifiche si può implementare in 1-2 settimane (3.000-8.000 euro). Un'integrazione avanzata con API REST InSite (checkout embedded), tokenizzazione per addebiti ricorrenti, Bizum e gestione completa degli errori può richiedere 3-5 settimane (8.000-20.000 euro). Se devi anche costruire la logica degli abbonamenti sopra la tokenizzazione di Redsys, il costo aumenta in base alla complessità del modello di billing.
Iniziamo

Integriamo Redsys nella tua piattaforma

Ti accompagniamo in tutta l'integrazione: dalla configurazione del POS con la tua banca al deployment in produzione con monitoraggio.

Prenota una call gratuita →