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 redsys


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

IMPORTANT: the virtual POS is already integrated in TuriTop, so it 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): "335088258"
  • Terminal number: "1"
  • Merchant Secure Key or Encryption key, HASH_Pru: "sq7HjrUOBfKmC576ILgskD5srU870gJ7"

NOTE:  In step 2, we show you where to add them.

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.


Step 3: Activate Test Mode

NOTE: The bank will request that these two options are met.

1- Place where the transaction takes place (add your tax address)

The banking entities ask their users to specify the country of origin of the transaction where the reservation is made.

To add text in TujriTopPara there are several otpions, for example, go to Company>>>Booking form>>and add a Custom HTML field. 


2- "Términos y condiciones".

 Due to security reasons, you need tu add "Terms and Conditions" to your booking form abd it can't be selected, as in the below image.

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.)


Possible values ​​of Ds_Response

(indicates the status of any transaction)