Pular para o conteúdo principal
Integração

Integração Redsys

Integramos a Redsys, o gateway de pagamentos dominante em Espanha, na sua plataforma web ou app. REST API, tokenização para cobranças recorrentes, 3D Secure 2.0, TPV virtual, Bizum e gestão completa dos ambientes de teste.

O gateway líder em Espanha

A Redsys processa a grande maioria dos pagamentos com cartão em Espanha

A Redsys é a infraestrutura de processamento de pagamentos utilizada pela maioria dos bancos espanhóis: CaixaBank, BBVA, Santander, Sabadell, Bankinter e muitos mais. Quando um comerciante espanhol aceita pagamentos com cartão, a transação passa pela Redsys na grande maioria dos casos. Isto torna-a o gateway de pagamentos mais importante do mercado espanhol, com as melhores taxas de aceitação para cartões emitidos por bancos nacionais e as comissões mais competitivas disponíveis.

Ao contrário de gateways internacionais como Stripe ou Adyen, a Redsys não é uma plataforma de pagamentos tudo-em-um. É especificamente um processador de pagamentos que liga a sua conta de comerciante à rede bancária espanhola. Isto tem vantagens e desvantagens: as comissões costumam ser mais baixas porque o seu banco adquirente negoceia as condições diretamente consigo, e as taxas de aceitação de cartões espanhóis são mais elevadas. Mas a integração técnica é mais complexa, a documentação tem sido historicamente limitada e funcionalidades como subscrições ou pagamentos de marketplace exigem implementação manual.

Se é uma empresa internacional que quer vender em Espanha, compreender a Redsys é importante, porque é assim que a maioria dos consumidores espanhóis paga online. Embora o Stripe funcione em Espanha, as transações encaminhadas pela Redsys através de um banco local têm frequentemente taxas de aceitação mais altas e custos mais baixos para cartões emitidos em Espanha. Para negócios focados sobretudo no mercado espanhol, a integração com a Redsys pode melhorar significativamente as taxas de conversão e reduzir os custos de processamento de pagamentos face à utilização exclusiva de um gateway internacional.

A API da Redsys evoluiu significativamente nos últimos anos. A moderna REST API substitui o clássico sistema de formulário com redirecionamento, permitindo uma integração muito mais flexível. A tokenização de cartões possibilita cobranças recorrentes sem armazenar dados sensíveis. O 3D Secure 2.0 com autenticação adaptativa reduz a fricção no checkout. E a integração do Bizum como método de pagamento permite aos utilizadores pagar diretamente a partir da app do seu banco com um único toque, alcançando taxas de conversão acima de 90% junto do público espanhol.

90%+

Bancos espanhóis

3DS2

3D Secure 2.0

Bizum

Pagamento móvel

Token

Cobranças recorrentes

Funcionalidades

O que integramos com a Redsys

Todas as funcionalidades do gateway, corretamente implementadas com as melhores práticas.

REST API

Integração com a moderna REST API da Redsys (InSite / REST JSON). Assinatura dos pedidos com HMAC SHA256 e a chave de encriptação do comerciante. Gestão correta dos fluxos de autorização, confirmação e notificação (URLs de OK, KO e notificação). Parsing e validação das respostas. Tratamento dos diferentes estados de transação e códigos de erro para dar feedback preciso ao utilizador.

Tokenização

Tokenização de cartões para cobranças recorrentes (COF - Credential on File). Armazenamento seguro dos tokens Redsys sem guardar dados de cartão no seu sistema. MIT (Merchant Initiated Transactions) para cobranças sem intervenção do utilizador. CIT (Cardholder Initiated Transactions) para cobranças autenticadas. Gestão do ciclo de vida dos tokens: criação, utilização e revogação. Conformidade PCI DSS ao nível SAQ-A.

3D Secure 2.0

Implementação do 3D Secure 2.0 em conformidade com a diretiva PSD2/SCA. Envio de dados de autenticação enriquecidos (morada de envio, histórico do cliente, dispositivo) para maximizar as aprovações sem fricção. Gestão do fluxo de challenge quando o emissor exige autenticação adicional. Isenções SCA configuráveis: transações de baixo risco (TRA), montantes reduzidos, comerciantes de confiança (whitelisting). Fallback para 3DS 1.0 quando o emissor não suporta a versão 2.0.

Bizum

Integração do Bizum como método de pagamento dentro do fluxo Redsys. Os utilizadores introduzem o número de telemóvel e confirmam o pagamento na app do seu banco. Taxas de conversão acima de 90% junto do público espanhol. Configuração do TPV virtual para aceitar Bizum a par dos pagamentos com cartão. Notificações de pagamento em tempo real. Essencial para negócios orientados ao consumidor espanhol que queiram maximizar a conversão.

TPV virtual

Configuração e gestão do terminal de ponto de venda virtual no painel de administração da Redsys. Registo do comerciante, configuração das moedas aceites, URLs de retorno, URLs de notificação e métodos de pagamento ativos. Gestão multicomerciante quando o seu negócio opera com diferentes entidades ou marcas. Personalização da página de pagamento alojada na Redsys com as cores e o logótipo da sua marca. Configuração de limites e restrições por tipo de operação.

Testes e erros

Configuração do ambiente de testes SIS-T da Redsys para desenvolvimento. Cartões de teste para simular diferentes cenários: pagamento com sucesso, recusado, timeout, 3D Secure. Mapeamento completo dos códigos de erro da Redsys (DSxxxx, SISxxxx) para mensagens compreensíveis. Registo detalhado das transações para debugging. Monitorização da taxa de erros e alertas automáticos quando são detetados padrões anómalos.

Precisa de integrar a Redsys no seu projeto?

Consultoria gratuita →
Comparação

Redsys vs Stripe: quando usar cada um

Nem sempre é uma decisão exclusiva. Em muitos projetos, a melhor abordagem é combinar os dois gateways.

Escolha a Redsys quando...

  • O seu público principal é espanhol e quer as melhores condições de comissão com o seu banco
  • Precisa de aceitar Bizum como método de pagamento
  • O seu banco oferece comissões negociadas muito competitivas
  • Opera num setor em que as taxas de aceitação de cartões espanhóis são críticas
  • Quer maximizar a confiança dos utilizadores espanhóis através da página de pagamento do banco deles

Escolha o Stripe quando...

  • Vende internacionalmente e precisa de suporte multimoeda e métodos de pagamento globais
  • Precisa de subscrições com faturação avançada (rateios, dunning, medição de consumo)
  • Opera um marketplace e precisa de pagamentos divididos (Stripe Connect)
  • Dá prioridade à experiência de programador e à qualidade da documentação
  • Precisa de prevenção de fraude avançada com ML (Stripe Radar)
Tecnologias

Stack tecnológico 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

Perguntas frequentes sobre a integração Redsys

Como se regista um comerciante na Redsys?
O registo do comerciante na Redsys é gerido através do seu banco adquirente (CaixaBank, BBVA, Santander, etc.). Solicita um TPV virtual ao banco, assina o contrato de comércio eletrónico e recebe as suas credenciais: número de comerciante (FUC), número de terminal e chave de encriptação. O processo demora normalmente 1-3 semanas, consoante o banco. Nós tratamos da parte técnica assim que tiver as credenciais: configuração do TPV, integração da API, testes em sandbox e passagem a produção.
A Redsys pode ser usada para cobranças recorrentes e subscrições?
Sim, através da tokenização COF (Credential on File). Na primeira transação com autenticação 3D Secure, a Redsys devolve um token que identifica o cartão do cliente. Esse token é guardado de forma segura e usado nas cobranças seguintes (MIT - Merchant Initiated Transactions), sem intervenção do utilizador. A diferença face ao Stripe Billing é que, com a Redsys, tem de construir a lógica de subscrições (quando cobrar, novas tentativas, rateios), enquanto o Stripe a gere de origem.
O que é o Bizum e porque é importante em Espanha?
O Bizum é o sistema de pagamento móvel mais popular de Espanha, com mais de 25 milhões de utilizadores — um número notável tendo em conta que Espanha tem cerca de 47 milhões de habitantes. Permite pagamentos instantâneos diretamente a partir das apps bancárias, apenas com o número de telemóvel. No e-commerce, o Bizum atinge taxas de conversão acima de 90% junto do público espanhol, porque não é preciso introduzir dados de cartão. Integra-se através da Redsys como método de pagamento adicional. Para qualquer negócio orientado ao consumidor espanhol, o Bizum é tão essencial como o Apple Pay ou o Google Pay.
Quais são os erros mais comuns na integração da Redsys?
Os erros mais comuns são: assinatura incorreta do pedido (erro SIS0042) devido a problemas de codificação Base64 ou de ordenação de parâmetros, URL de notificação inacessível a partir dos servidores da Redsys (tem de ser pública, não localhost), confusão entre o ambiente de testes (sis-t.redsys.es) e o de produção (sis.redsys.es) e tratamento incorreto do fluxo 3D Secure, que leva a transações recusadas. Embora a documentação da Redsys tenha melhorado, continua a ter lacunas que se resolvem melhor com experiência prática.
Quanto custa uma integração Redsys?
Uma integração Redsys standard com checkout por redirecionamento, 3D Secure e notificações pode ser implementada em 1-2 semanas (3.000-8.000 euros). Uma integração avançada com REST API InSite (checkout embebido), tokenização para cobranças recorrentes, Bizum e tratamento completo de erros pode exigir 3-5 semanas (8.000-20.000 euros). Se também precisar de construir a lógica de subscrições sobre a tokenização da Redsys, o custo aumenta consoante a complexidade do modelo de faturação.
Vamos começar

Vamos integrar a Redsys na sua plataforma

Ajudamos em toda a integração: da configuração do TPV com o seu banco à passagem a produção com monitorização.

Agende uma call gratuita →