How to Set Up Redsys

06.06.2017 16:01:01

If you decided to receive payments from your customers using the virtual Point of Sale (POS) of your own bank, these are the steps necessary to activate it.

logo redsysOnce you have applied to your bank for having a virtual POS, you will receive a long and complex email from Redsys.

IMPORTANT: the vistual POS is already integrated in TuriTop, so isn't necessary to read all the incomprehensible email from Redsys, but follow these 7 steps:

NOTE: Scroll to the bottom to see the possible values ​​of Ds_Response (Indicates the status of any transaction)

Step 1: Set up Email

Inside Redsys email you will get the information to configure your virtual POS for "testing mode"

Take a look at this information:

  • Merchant Code (FUC): "322388123"
  • Terminal number: 001
  • Merchant Secure Key or Encryption key: "sq7HjrUOBfKmC576ILgskD5srU870gJ7"

Step 2: Select Redsys payment gateway

Enter to your TuriTop Control Panel and go to the "Company" tab >>> "RECEIVING PAYMENTS" >>> "Redsys PAYMENT GATEWAY (Spain)"

Now copy and paste the three codes received in the mail.

NOTE: Leave Auto-capture payment marked to receive payments instantly. Unmark this box if you want to save your customers credit card information for a limited time (ask your bank a bout the limit), and capture the payment manually from your Redsys control panel. You need to request to your bank to activate this option before you unmark Auto-capture payment.

Captura de pantalla 2015-12-29 a las 16.03.29

Step 3: Activate Test Mode

Redsys 2

Step 4: Make purchasing tests

Redsys will ask you to perform these tests. You must perform directly from your booking widget, either within your TuriTop Control Panel or from your own website, if you have already installed.

Perform at least one unauthorized operation. Use the card they provide or use this test card

  • Card Number: 4548812049400004
  • Expiration: 12/20
  • CVV2 code: 123
  • CIP code: 123456

Perform at least one Denied operation. Use  the card they provide or use this test card

  • Card Number: 1111111111111117
  • Expiration: 12/20
  • Don't write anything else and click the pay button.

Make an attempt of iuPay payment. It is not necessary to finish the operation. NOTE: If you do not know which is iuPay or have any problems due to their configuration, ask your bank to turn it off.

Step 5: Apply the actual keys

Send email to the Redsys support to receive your new key to real mode.

You can copy and paste this text in Spanish that we have pre-designed for you:


Subject: Transition to real environment (production)



Solicitamos pasar al entorno REAL (PRODUCCIÓN) para la empresa “NOMBRE DE TU EMPRESA”. Ya hemos realizados las operaciones en el entorno de Test.

Un saludo,


Step 6: Enter real Key (production)

Once you get the email with instructions on how to get the key to real mode, do the following:

  • Enter to your Redsys control panel by clicking HERE. NOTE: your username is your Merchant code and Terminal (i.e. 123456789-001). If you forget your password click "¿Has olvidado la contraseña?" ro receive a new one.
  • Click the cart icon (Adm. TPV virtual)
  • Click "Comercios"
  • Click "Consultar"
  • Click "Ver/Mostrar Clave" (enter your password again)
  • Copy the key (you'll have 10 seconds to do it)
  • Open your TuriTop control panel.
  • Go to "Company" & gt; & gt; & gt; "Receiving Payments" >>> "Redsys"
  • Paste the new code where it says "Merchant Secure Key or Encryption key"
  • Deactivate the Test Mode of the Virtual POS from your TuriTop control Panel.

Step 7: Make the last tests in Real mode

  • Make an Authorized transaction with a valid credit/debit card. From the Administration module you can generate a refund.
  • Make a Denied transaction with the card: 1111111111111117
  • Check the Administration module ro see all transactions. (Access to "Consultas").
  • Check that the notifications are correct. Access the Administration Module ("Notificaciones" button.)


Add a note stating the country where the transaction takes place

Redsys is asking their users to specify the country of origin of the transaction. Because of this in TuriTop we explain how to add text in three places in the widget:

    1.- Just below the button Next >> in the widget.

Copy the code that you see below (just the part that affects your language) into your Design sheet in the Design tab. Only change the part where it says Your Text, leaving the inverted commas. Change the language that this code will affect to bt changing the es/en Tienes que copiar el código que te dejamos aquí abajo cambiando el Tu Texto o Your Text dentro de las comillas por el mensaje que necesites añadir. Elige también el código dependiendo del idioma que necesites. Si es alguno diferente al que aquí te mostramos cambia el lang(es) por el código de tu idioma.

/*Text in English for English widget*/
html:lang(en) div#buttons_area::after {
content: 'Your Text';
display: block;
position: inherit;
text-align: inherit;
color: grey;
font: 0.8em bold;
padding-top: .5em;
/*Texto en Español para el widget en Español*/
html:lang(es) div#buttons_area::after {
content: 'Tu Texto';
display: block;
position: inherit;
text-align: inherit;
color: grey;
font: 0.8em bold;
padding-top: .5em;

    2.- Go to Services >>> Your Service (P1, P2, P3, ...) >>> Tickets and you can add text in the field Pricing Notes. The text will appera below the tickets in the Widget.

    3.- Go to Services >>> Your Service (P1, P2, P3, ...) >>> Booking form and add a custom HTML field. You can add text here and it will appear where your clients add their information. 

Possible values ​​of Ds_Response

(indicates the status of any transaction)

Let's Get In Touch!

Ready to start your next project with us? That's great! Give us a call or send us an email and we will get back to you as soon as possible!

(+34) 922 394 632