« Volver al índice  « Volver al plugin

El formulario o botón de pago puede insertarse en cualquier lugar de la web mediante el shortcode:

[boton_redsys]

Es posible insertar tantos botones como se quiera, incluso en la misma URL.

En su versión más simple, tal como aparece arriba, el shortcode mostrará un formulario con un campo para introducir la cantidad (a no ser que se establezca mediante un enlace, ver la sección Generador de enlaces de esta documentación) y los campos que estén habilitados mediante los ajustes del formulario: correo electrónico, concepto, casilla de aceptación.

Pero además, el shortcode admite otros atributos para personalizar cada uno de los botones que se establezcan en la web: texto, cantidad, metodo, concepto, idioma, color_f, color_t y campos.

El atributo texto

El atributo texto permite personalizar el texto que mostrará el botón de pago. Por ejemplo:

[boton_redsys texto="Pagar ahora"]

De no especificarse el atributo, se utilizará el texto establecido en la opción Texto del botón de la pestaña Formulario de los ajustes del plugin.

El atributo cantidad

Usando el atributo cantidad se puede establecer una cantidad predefinida para el pago. Cuando está presente, el campo para solicitar la cantidad no se muestra. Se debe establecer una cantidad numérica, sin el símbolo de moneda (si se añade algún carácter no numérico el botón no reconocerá el atributo y, por lo tanto, solicitará la cantidad al usuario). Por ejemplo:

[boton_redsys cantidad="325,90"]

Para los decimales se puede utilizar tanto un punto como una coma. Al establecer la cantidad de esta forma es recomendable tener activada la opción Indicar la cantidad en el botón en la pestaña Formulario de la página de ajustes del plugin, de forma que el usuario pueda ver claramente qué cantidad va a pagar.

El atributo metodo

Este atributo permite establecer un método de pago específico (tarjeta o Bizum) para ese botón concreto, que puede ser diferente al método de pago establecido en la opción para el método de pago por defecto de los ajustes del TPV. Sus valores pueden ser:

• tarjeta o c (también admite la errata targeta) para pagos con tarjeta.
• bizum o z para pagos con Bizum.

Por ejemplo, si creamos un botón usando el shortcode:

[boton_redsys metodo="bizum"]

Todos los pagos realizados a través de ese botón serán mediante Bizum.

>>Quizá también te interese: Añadir un selector de método de pago.

El atributo concepto

El atributo concepto permite establecer un concepto para el formulario en lugar de solicitarlo al usuario. Por ejemplo:

[boton_redsys concepto="Pago de la factura nº 3552"]

En este caso, el concepto se mostrará bajo el botón, precedido por el texto establecido en la opción Texto para el concepto en el shortcode de la pestaña Formulario de la página de ajustes del plugin.

El atributo idioma

Atención: No todos los bancos aceptan todos los idiomas.

Atención: Este atributo no establece en qué idioma se mostrará el botón o el formulario, sino en qué idioma se mostrará la interfaz de la pasarela de pagos (siempre que ese idioma esté disponible en tu banco).

Este atributo permite establecer el idioma en que se mostrará la interfaz de Redsys durante el pago, pudiéndose así establecer de forma independiente en cada uno de los botones que se configuren (para usarlos, por ejemplo, en páginas con diferentes idiomas). De no estar especificado este atributo en el shortcode, la interfaz de Redsys se mostrará en el idioma establecido en los ajustes del TPV.

Para establecer el idioma se usa el código ISO 639-1 de dos letras. Como este formato no tiene un código para el valenciano en este caso se usa val. Se puede utilizar cualquiera de los idiomas disponibles para Redsys (da igual si el código se escribe en mayúsculas o minúsculas):

• Español/castellano: es
• Inglés: en
• Catalán: ca
• Francés: fr
• Alemán: de
• Holandés: nl
• Italiano: it
• Sueco: sv
• Portugués: pt
• Valenciano: val
• Polaco: pl
• Gallego: gl
• Euskera: eu
• Búlgaro: bg
• Chino: zh
• Croata: hr
• Checo: cs
• Danés: da
• Estonio: et
• Finlandés: fi
• Griego: el
• Húngaro: hu
• Japonés: ja
• Letón: lv
• Lituano: lt
• Maltés: mt
• Rumano: ro
• Ruso: ru
• Eslovaco: sk
• Esloveno: sl
• Turco: tr

Por ejemplo:

[boton_redsys idioma="en"]

Los atributos color_f y color_t

Estos atributos permiten personalizar los colores de fondo (color_f) y de texto (color_t) de cada botón individual, al margen de los ajustes generales establecidos en la página de opciones del plugin.

El valor introducido debe estar en formato de color hexadecimal (aquí puedes encontrar un generador visual del código hexadecimal para cada color), por lo que es mucho más sencillo establecerlo mediante el widget de sidebar, el bloque de Gutenberg o el widget para Elementor que incluye el plugin, ya que en estos casos podrás hacerlo mediante un selector visual de colores.

Ejemplo:

[boton_redsys color_f="0075b0" color_t="fff"]

El atributo campos

Este atributo permite generar un botón de pago que no incluya los campos personalizados, aunque éstos se hayan configurado en los ajustes generales. Para que esto suceda, basta con incluir este atributo con cualquier valor. Por ejemplo:

[boton_redsys campos="no"]

Nótese que la sola presencia de este atributo (independientemente del valor que se le dé) hace que los campos no se muestren, por lo que:

[boton_redsys campos="si"]

también hará que el botón se muestre sin los campos personalizados. Para que estos se muestren, basta con no incluir este atributo en el shortcode.

Uso de los atributos

Por supuesto, un shortcode se puede usar sin atributos, como en el primer ejemplo mostrado en esta sección, con un sólo atributo, con dos, tres o con todos. Por ejemplo:

[boton_redsys cantidad="325,90" concepto="Pago de la factura nº 3552" color_f="#0075b0" color_t="#fff"]

« Volver al índice  « Volver al plugin