Documentació per a desenvolupadors
Targetes de prova Redsys i guia de sandbox
Valida la integració amb les targetes de prova de Redsys i credencials pròpies de sandbox. Comprova el resultat bancari, la comanda i el lliurament, a més del que veu el comprador.
Targetes de prova Redsys: número, caducitat i CVV
| Escenari | Targeta | Caducitat | CVV |
|---|---|---|---|
| VISA genèrica · EMV3DS 2.2 | 4548810000000003 | 12/49 | 123 |
| Autorització sense challenge · EMV3DS 2.1 | 4548814479727229 | 12/49 | 123 |
| Autorització amb challenge · EMV3DS 2.1 | 4548817212493017 | 12/49 | 123 |
| Rebuig · autentica correctament al simulador | 4548810000000003 | 12/49 | 999 |
12/49 és una caducitat d’exemple; Redsys admet una data futura. El CVV 999 simula una denegació amb la targeta genèrica. Completa correctament l’autenticació al simulador per comprovar aquest rebuig.
Targetes i entorns de prova oficials de Redsys
Prova també l’abandonament del challenge, la recàrrega i el retorn tardà. Davant d’un resultat incert, consulta l’operació existent abans de sol·licitar un altre cobrament.
Preparar l’entorn de proves
- 1
Configura el compte Redsys de proves
Desa el FUC, el terminal i el secret de sandbox facilitats per al TPV. Les credencials de producció són diferents. El compte de demostració genèric de Redsys no substitueix l’activació d’inSite per al teu comerç. - 2
Genera una clau ap_test_
La clau d’API fixa l’entorn de cada checkout en crear-lo. No reutilitzis una clau ap_live_ durant les proves. - 3
Autoritza el domini
Redsys inSite ha de permetre l’origen HTTPS exacte on es carrega el formulari de targeta. - 4
Configura el webhook
Utilitza una URL pública HTTPS i conserva el secret de signatura de sandbox al servidor.
Provar Bizum
Al sandbox utilitzat per la nostra integració, fes servir el mòbil 700 000 000 (+34700000000). Un import inferior a 5 € autoritza, entre 5 € i 10 € rebutja i per sobre de 10 € no admet la prova. Confirma les condicions de l’entorn assignat al terminal.
Verifica l’autorització a l’app bancària, el rebuig, l’abandonament i el callback tardà. Bizum requereix RTP habilitat pel banc; AndorPay no passa automàticament a una redirecció clàssica si RTP no està disponible.
Provar Apple Pay i Google Pay
Apple Pay
Apple Sandbox permet validar el full de pagament, l’elegibilitat i la sessió del comerç a Safari i en un dispositiu compatible. El sandbox Redsys ordinari pot rebutjar X-PAY. L’autorització completa requereix l’entorn de certificació acordat amb Redsys o el banc.
Google Pay
A Configuració → Raïls → Redsys, selecciona Proves, activa Google Pay i desa. La selecció es conserva per entorn: activar-lo en proves no l’activa en producció.
La integració utilitza Google TEST i gateway=redsys. El full es pot obrir sense un merchant ID de producció, però l’autorització requereix X-PAY habilitat al terminal i una targeta compatible amb CRYPTOGRAM_3DS.
Provar webhooks i evitar efectes duplicats
| Cas | Resultat esperat |
|---|---|
| Signatura vàlida | L’endpoint accepta el cos exacte i retorna 2xx. |
| Signatura modificada | Retorna 400 abans d’interpretar o aplicar l’esdeveniment. |
| Marca temporal antiga | Rebutja una diferència superior a 5 minuts. |
| Resposta 500 | AndorPay conserva event.id i programa un nou lliurament. |
| Esdeveniment repetit | Reconeix event.id i no repeteix l’efecte de negoci. |
| Esdeveniments fora d’ordre | Decideix segons el contingut i l’estat, no només per l’ordre d’arribada. |
Provar pagaments recurrents amb Redsys
Un primer pagament correcte no valida una subscripció completa. Amb la tokenització i la recurrència habilitades al terminal de proves, comprova també aquests casos:
| Cas | Resultat esperat |
|---|---|
| Alta i primera operació | Relaciona client, consentiment, referència de pagament i subscripció. |
| Renovació posterior | Verifica una operació MIT i el període corresponent, sense repetir la compra inicial. |
| Renovació rebutjada o pendent | No ampliïs l’accés com si estigués pagat; resol l’estat abans d’un altre càrrec. |
| Notificació repetida | Un mateix pagament no amplia dues vegades el període ni duplica el lliurament. |
| Baixa | Comprova la data d’efecte i que no quedi programat un càrrec posterior a la baixa efectiva. |
Requisits i funcionament dels pagaments recurrents a Andorra
Criteris per tancar les proves
Una autorització i un rebuig han de produir estats coherents a Redsys, AndorPay i la teva aplicació. El webhook vàlid activa una sola vegada l’efecte esperat; la signatura invàlida no l’activa; un pagament pendent no provoca un segon cobrament a cegues.
Repeteix el recorregut en ordinador i mòbil. Conserva request_id, event.id i la referència interna de la comanda, sense registrar claus d’API, secrets, PAN, caducitat ni CVV.
Passos següents
Documentació tècnica addicional en castellà: Signatura i reintents de webhooks · Pas a producció