Guide

How to set up Redsys on WooCommerce, step by step

From requesting your virtual POS (TPV) to your first live payment: the exact values you need and where they go.

Last updated June 2026 6 min read Setup guide
The short answer

To accept Redsys payments on WooCommerce you need a virtual POS (TPV Virtual) from your bank. It gives you three values — merchant code (FUC), terminal number and the SHA-256 secret key — that you paste into the plugin. Set it to the test environment, run a test order, then switch to live.

What you need first

Three things: a WooCommerce store, a Redsys virtual POS from your bank, and the plugin.

You need an active WooCommerce store, a contract with your bank for a Redsys virtual POS (TPV Virtual), and the plugin — the free Lite version or Premium for embedded checkout, tokenization and more.

Get your Redsys credentials

Your bank issues the virtual POS and gives you the three values the plugin needs.

  1. Contact your bank and request a TPV Virtual (Redsys virtual POS) for your online store.
  2. Once approved, you receive the merchant code (FUC / número de comercio) and the terminal number.
  3. Get the SHA-256 secret key. Many banks let you view or regenerate it in the Redsys administration module (Canales).
  4. Keep these three values private — the secret key signs every transaction.

Install the plugin

  1. Lite: in WordPress go to Plugins > Add New, search "Redsys WooCommerce", install and activate.
  2. Premium: download the ZIP from plugins.joseconti.com, then Plugins > Add New > Upload Plugin, and activate.

Configure the plugin

Enter your three values and pick the test environment while you verify.

  1. Go to WooCommerce > Settings > Payments and open the Redsys gateway you want (card, Bizum, …).
  2. Paste the merchant code, terminal number and SHA-256 secret key.
  3. Set the environment to Test.
  4. Enable the payment methods you offer and save.

Test before charging real customers

Always run a test order in the Redsys test environment first.

  1. Keep the environment on Test.
  2. Place an order and pay with the Redsys test cards from your bank or Redsys documentation.
  3. Confirm the order moves to a paid status, and check the plugin logs if anything fails.
  4. If you see error SIS0042, the secret key is wrong — re-copy it exactly.

Go live

  1. Switch the environment from Test to Live (Real) and save.
  2. Clear any page or object cache.
  3. Place one small real order and confirm it completes.
  4. Refund that order from the WooCommerce order screen to confirm refunds work.

Frequently asked questions

Yes. Redsys is the gateway your Spanish bank provides. You must request a TPV Virtual from your bank; they give you the merchant code, terminal number and secret key.
Your bank provides it. Many banks let you view or regenerate it in the Redsys administration module (Canales). It must match exactly or you get error SIS0042.
Both set up the same way with the same three values. Lite covers card redirect, Bizum, Apple/Google Pay redirect and Inespay. Premium adds embedded checkout (InSite), tokenization, express buttons and more.
Yes. Set the plugin to the Test environment and pay with the Redsys test cards. Switch to Live only when a test order completes correctly.
Free for nonprofits

José Conti provides premium payment gateway plugins completely free, with lifetime support, for legally registered nonprofit organizations. If you run a nonprofit and need to accept payments through Redsys, apply for a free license.

Apply for a free license

Take your first Redsys payment

Start free with Lite, or get Premium for embedded checkout, tokenization and direct support.