Andorpay
Torna al blog

Publicat el · Actualitzat el

Proves Redsys: guia per a WooCommerce i API

Pla de proves Redsys per a WooCommerce i API: targetes de sandbox, 3DS, rebutjos, webhooks i renovacions. Comprova les comandes abans de publicar.

Portàtil amb un formulari de pagament i fitxes per provar confirmació, espera i retorn.

Per provar Redsys, comença per l’entorn sandbox i els escenaris d’autorització, 3DS i rebuig. Si busques una targeta de prova Redsys amb caducitat i CVV, consulta la taula de targetes i la configuració del sandbox. Aquesta guia desenvolupa el pla complet de proves per a WooCommerce o una integració API, incloses les renovacions de subscripcions.

Provar una integració de pagaments vol dir comprovar que el comprador, el sistema de cobrament i el teu negoci acaben amb el mateix resultat. Veure una pantalla de «pagament completat» només és una part de la feina. També has de saber què passa quan el banc rebutja l'operació, el client tanca la pestanya o una confirmació arriba dues vegades.

Per a una empresa d'Andorra que connecta el seu TPV amb AndorPay, l'objectiu és concret: cobrar quan toca, entregar una sola vegada i poder reconstruir qualsevol operació a partir de les seves referències. Aquesta guia organitza les proves per casos i resultats comprovables, tant en una aplicació pròpia com a WooCommerce.

Què ha de demostrar una prova de pagament

Cada prova necessita un resultat esperat en tres llocs: la pantalla del comprador, l'estat del pagament i l'estat de la comanda o del servei. Si el pagament està confirmat però la comanda continua pendent, encara queda alguna cosa per resoldre.

Afegeix-hi una quarta comprovació: l'acció que ha de fer el negoci. Preparar un enviament, activar un accés o enviar una confirmació s'ha de fer segons la regla definida i sense duplicats. Un estat correcte a la base de dades no és suficient si el magatzem rep dues ordres de preparació.

Per exemple, en la compra d'un recurs digital, pots esperar un pagament confirmat, una comanda pagada i un únic accés actiu. Si es repeteix la notificació, l'accés ha de continuar sent el mateix. Així, la idea genèrica que «funciona» es converteix en una comprovació concreta.

Prepara un entorn que separi les proves de les vendes

Fes servir les credencials de sandbox corresponents. A AndorPay, una clau que comença per ap_test_ selecciona l'entorn de proves de la sessió; les claus de producció comencen per ap_live_. L'entorn d'una sessió no canvia després de crear-la.

Comprova també el comerç, el terminal i les credencials de Redsys de proves. Una clau correcta de l'aplicació no resol una configuració bancària equivocada. Si utilitzes targeta amb inSite, cal que estigui permès l'origen HTTPS exacte on es carrega el formulari.

Prepara una comanda de prova fàcil de reconèixer, un comprador fictici i una adreça de retorn vàlida. Evita que aquesta operació provoqui un enviament real o un correu desconcertant a un client. La recepció de notificacions ha de ser accessible per HTTPS i fer servir el secret de signatura de l'entorn corresponent.

La guia de proves d'AndorPay recull les dades i les condicions vigents. Per a les targetes, consulta també els entorns oficials de Redsys. Les dades de prova no serveixen per pagar en producció.

Eines: una per a cada pregunta

No necessites acumular programes. Necessites observar la petició, la resposta, la interacció del comprador i el resultat al teu negoci.

Eina Què permet comprovar Què no demostra tota sola
Client HTTP o cURL Autenticació, dades enviades i resposta de l'API Que el comprador hagi pagat
Navegador i eines de desenvolupament Redirecció, missatges, errors i comportament al mòbil L'estat bancari definitiu
Registre del servidor Recepció d'esdeveniments i aplicació de regles Què ha vist el comprador
Consulta de comanda i pagament Correspondència entre referències i estats Que totes les incidències estiguin cobertes
Prova automatitzada Repetició de casos controlats Funcionament real de tots els dispositius i bancs

Comença amb una petició mínima que funcioni i després integra-la a l'aplicació. Així distingiràs un error de credencials d'un problema introduït pel codi. Guarda les referències necessàries per seguir l'operació entre sistemes.

Si una prova falla, canvia una sola variable cada vegada. Comprovar credencials, domini i dades de la compra alhora fa difícil saber què ha resolt el problema. Torna a executar el cas original després del canvi i conserva el resultat amb la versió provada.

Crear una sessió no vol dir haver cobrat

En la integració REST, una resposta correcta de creació proporciona l'adreça del checkout allotjat. Obre aquesta adreça tal com la retorna l'API. No construeixis una URL semblant ni interpretis la creació de la sessió com una venda pagada.

Abans de provar targetes, comprova tres casos: credencial incorrecta, dades invàlides i creació vàlida. Els dos primers han de donar un error comprensible i mantenir la comanda sense pagar. El tercer ha de conservar la relació entre comanda i sessió abans d'enviar el client al checkout.

Respecta el contracte de cada operació. Per exemple, POST /v1/checkouts no admet la capçalera Idempotency-Key. Afegir-la a totes les peticions com a regla general provoca un error. La documentació REST explica el comportament d'aquest endpoint.

Si l'aplicació perd la resposta o rep un resultat pendent, investiga la sessió i l'operació existents abans de crear un altre cobrament. Tornar a intentar una comunicació i demanar una nova autorització de pagament són accions diferents.

Els casos mínims que cal provar amb targeta

Prova els escenaris disponibles al teu entorn bancari amb les dades específiques de prova. Escriu el resultat esperat abans d'executar cada cas.

Cas Què ha de veure el comprador Què ha de comprovar el negoci
Pagament autoritzat Confirmació i següent pas clars Pagament confirmat i entrega única
Autenticació addicional Indicacions per completar la validació Comanda pendent fins a conèixer el resultat
Pagament rebutjat Missatge útil i una manera adequada de continuar Sense entrega ni marca de pagat
El client cancel·la Retorn comprensible a la compra Estat coherent amb el resultat real
El client tanca la pestanya Pot consultar la compra més endavant La confirmació no depèn del seu retorn
Resposta pendent Missatge d'espera que no empenyi a pagar de nou Consulta i resolució de l'operació existent

En el cas d'autenticació addicional, prova de completar-la i d'abandonar-la. Si només assages el recorregut ràpid, no sabràs si la botiga recupera bé el control quan el banc demana un pas més.

Després repeteix una compra des del mòbil. Revisa el teclat, el desplaçament, el canvi a l'aplicació bancària i el retorn al navegador. El comprador ha de reconèixer el producte i el total durant tot el recorregut.

Comprova igualment una compra amb les opcions habituals de la botiga: enviament, descompte o canvi de quantitat, si escau. El total enviat a pagar ha de correspondre a la comanda que acabarà preparant el negoci, també després de modificar el carretó.

El retorn del navegador no confirma el pagament

Una adreça d'èxit serveix per continuar l'experiència del comprador. No ha de ser l'única condició per entregar una comanda. El client pot tancar la pestanya després d'autoritzar; també pot tornar a una adreça desada sense haver fet cap compra nova.

Comprova que el servidor decideix a partir d'una confirmació verificada o d'una consulta autoritzada de l'estat. Obre de nou la pàgina de retorn: no ha de crear una altra entrega ni canviar el resultat arbitràriament.

Fes també la prova inversa: tanca el navegador després de l'autorització i comprova què passa amb la comanda. Si es completa correctament mitjançant la notificació, hauràs comprovat que el negoci no depèn d'aquell últim clic del client.

Prova les notificacions, incloses les que fallen

Un webhook és una notificació enviada al teu servidor. A AndorPay, cal verificar-ne la signatura abans d'aplicar cap efecte. La guia de webhooks explica la validació sobre el cos original i la finestra temporal admesa.

Prepara aquests casos en un entorn controlat:

  1. Signatura vàlida: el receptor accepta l'esdeveniment i actualitza l'operació correcta.
  2. Signatura alterada: es rebutja sense modificar comandes ni accessos.
  3. Marca temporal fora de la finestra: es rebutja d'acord amb el contracte.
  4. Fallada temporal del receptor: un lliurament posterior pot completar la feina pendent.
  5. Mateix esdeveniment repetit: es reconeix pel seu identificador i no repeteix l'entrega.
  6. Esdeveniments rebuts en un ordre diferent: el sistema conserva un estat coherent i no decideix només segons l'ordre d'arribada.

La detecció de duplicats també ha de protegir les accions que se'n deriven. Comprova el correu, l'accés i la tasca de preparació, a més del registre de la comanda. Un esdeveniment repetit no hauria de generar diverses accions comercials equivalents.

Simula la fallada del receptor en una instal·lació de proves. Anota quin esdeveniment ha quedat pendent, quan ha tornat a arribar i quin efecte ha produït. No interrompis deliberadament la recepció de vendes reals per fer aquest assaig.

Si la teva botiga funciona amb WooCommerce

Fes la prova des d'una finestra privada i amb un producte identificable. Comprova la configuració de proves del plugin, la moneda i el recorregut real de la botiga. Inclou el teu tipus de checkout i les extensions que modifiquen camps, enviaments o descomptes.

Després de pagar, revisa l'estat de la comanda, les notes i la referència de transacció. El text de la pantalla ha de coincidir amb aquestes dades. Si tens diverses pestanyes obertes, comprova també que l'operació correspon a la comanda correcta.

El plugin utilitza notificacions i mecanismes de recuperació. Si una confirmació no arriba a temps, revisa la connexió amb l'endpoint i les tasques programades abans de concloure que el banc ha rebutjat el pagament. Per al diagnòstic tècnic, els registres andorpay-card-gateway i el grup andorpay-card d'Action Scheduler ajuden a seguir el recorregut.

L'acció de sincronització del pagament consulta l'operació existent. Serveix per recuperar-ne l'estat; no és una autorització nova ni justifica marcar una comanda com a pagada sense comprovar-la. Segueix la guia de WooCommerce per a la configuració vigent.

Apple Pay, Google Pay i Bizum necessiten proves pròpies

Veure un botó no vol dir haver validat una autorització completa. Comprova primer si el dispositiu i el navegador compleixen els requisits; després, la presentació del mètode i, finalment, el resultat del pagament quan l'entorn ho permeti.

Amb Apple Pay, una prova pot validar la pantalla de pagament i la sessió del comerç sense completar una autorització al sandbox ordinari de Redsys. La prova completa depèn de l'entorn de certificació acordat i de les capacitats habilitades.

Amb Google Pay, obrir la pantalla en mode de proves tampoc demostra una autorització amb Redsys. Cal complir les condicions del terminal, X-PAY i el tipus de credencial de prova descrits a la documentació.

Per a Bizum, la nostra integració utilitza RTP. Verifica'n la disponibilitat i els casos de l'entorn corresponent. No pressuposis que una fallada activa automàticament el flux clàssic de redirecció. Anota per separat què has provat i quina validació queda pendent.

Subscripcions: prova què passa després de l'alta

Si cobres subscripcions, una primera compra correcta no valida la renovació. Afegeix un cicle de renovació, un resultat fallit i les accions posteriors que utilitza realment la teva aplicació.

Comprova a quin període correspon el pagament i com afecta l'accés. Per exemple, un intent fallit no hauria de crear una segona subscripció per al mateix servei. Defineix quin missatge rebrà el client i què veurà la persona que atengui la incidència.

Les operacions disponibles depenen de la configuració del compte i del contracte documentat. Una capacitat no habilitada ha de donar un resultat controlat. No converteixis aquest error en una confirmació fictícia perquè el recorregut sembli complet.

Separa també les devolucions dels cobraments. L'API de reemborsaments sobre Redsys no està habilitada en el recorregut documentat d'AndorPay. La prova ha de comprovar que una operació no suportada no marca falsament el pagament com a reemborsat; cal acordar la gestió aplicable pel canal corresponent.

Què has de guardar per investigar un resultat inesperat

Prepara una fitxa breu per prova. Ha de permetre que una altra persona reconstrueixi què ha passat sense repetir un cobrament per «veure què passa».

Camp Exemple de contingut útil
Cas Autenticació completada i navegador tancat després
Entorn Sandbox i versió de la integració
Referències Comanda, sessió, request_id i event.id, quan existeixin
Resultat esperat Comanda pagada i un únic accés
Resultat observat Estat del pagament, comanda i acció executada
Evidència Hora, resposta rellevant i registre sense secrets
Seguiment Error corregit o limitació pendent de verificar

No hi incloguis claus d'API, secrets, números complets de targeta ni codis de seguretat. Conserva els identificadors i missatges necessaris per al diagnòstic. L'evidència ha d'explicar una operació sense convertir-se en una còpia de les dades de pagament.

Quan pots donar les proves per acabades

Pots tancar un cas quan el resultat esperat coincideix amb l'observat i les accions s'executen una sola vegada. Si només has vist obrir-se una wallet, registra aquest abast concret. No ho converteixis en una validació del mètode sencer.

Abans de passar a producció, revisa les credencials, els dominis permesos i la recepció d'esdeveniments d'aquell entorn. La validació real ha de tenir un abast acordat i autorització per a l'operació. Sandbox i producció són comprovacions diferents.

Conserva una petita selecció de proves per repetir després d'actualitzar el plugin, canviar el checkout o modificar la lògica d'entrega. Prioritza autorització, rebuig, confirmació duplicada i recuperació: afecten directament la manera de cobrar i atendre els clients.

Una integració preparada per al teu dia a dia

Si encara estàs decidint com connectar el negoci, comença per la diferència entre checkout allotjat i API. Si ja tens desenvolupament propi, la guia de SDK per integrar pagaments delimita què resol l'eina i què continua a la teva aplicació.

A AndorPay podem revisar amb tu el recorregut que necessita el teu negoci a Andorra i les comprovacions de la connexió. Explica'ns quina plataforma utilitzes i com cobres per plantejar una integració amb resultats clars des de la primera prova.

WhatsApp