Checkout SDK

Checkout SDK utiliza una Biblioteca del Lado del Cliente en JavaScript que se puede integrar fácilmente en tu página de pago.

Esta biblioteca se encarga de renderizar la interfaz de usuario y de gestionar la comunicación necesaria con la Plataforma Paylands para ejecutar cualquier tipo de transacción de manera fluida.

Para poder utilizar el SDK será necesario previamente haber generado una orden en Paylands. Esta orden deberá contener el uuid del checkout creado previamente. Ejemplo:

"extra_data": {
    "checkout": {"uuid": <UUID de tu checkout>}
}

En nuestra página, cargaremos el script del checkout

<script async src="https://ws-paylands.paynopain.com/assets/checkout/paylands-checkout-sdk.js"></script>

Y a continuación inicializaremos el SDK

const paylandsCheckout = await PaylandsCheckout.create({token: '9fdade323e7...'});

Request
token	Obligatorio	Token de la orden generada previamente
language	Opcional Por defecto: "es"	Idioma del checkout
environment	Opcional Valores: "PRODUCTION", "SANDBOX" Por defecto: "PRODUCTION"	Entorno

Esto nos dará acceso a todas las funciones del SDK.

Redirección

Redirigirá al usuario al checkout creado y personalizado anteriormente.

await paylandsCheckout.redirect();

Renderizado

Nos permitirá renderizar el checkout creado y personalizado en nuestra propia página.

await paylandsCheckout.render('renderContainer');

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el checkout

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Formulario de tarjeta

Nos permitirá renderizar un formulario de tarjeta personalizable en nuestra página.

await paylandsCheckout.card({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
holderLabel	Opcional	Label del input del propietario de la tarjeta
holderError	Opcional	Error a mostrar si el valor es incorrecto
panLabel	Opcional	Label del input del PAN de la tarjeta
panError	Opcional	Error a mostrar si el valor es incorrecto
expiryLabel	Opcional	Label del input de la fecha de caducidad de la tarjeta
expiryError	Opcional	Error a mostrar si el valor es incorrecto
cvvLabel	Opcional	Label del input del CVV de la tarjeta
cvvError	Opcional	Error a mostrar si el valor es incorrecto

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento card_valid.

window.addEventListener('message', event => {
    if (event.data.card_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.card_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor card.

button.addEventListener("click", () => window.postMessage({ pay: "card" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Google Pay

Nos permitirá renderizar un botón de Google Pay. Es necesario haberlo configurado previamente.

await paylandsCheckout.google_pay('renderContainer');

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón de Google Pay

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Apple Pay

Nos permitirá renderizar un botón de Apple Pay. Es necesario haberlo configurado previamente. Ten en cuenta que Apple Pay solo es compatible con dispositivos Apple y Safari. En cualquier otro caso, no se mostrará el botón.

await paylandsCheckout.apple_pay('renderContainer');

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón de Apple Pay

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

PayPal

Nos permitirá renderizar un botón de PayPal. Es necesario haberlo configurado previamente.

await paylandsCheckout.payPal({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
form (Object)	Obligatorio	Configuración del botón
customization (Object)	Obligatorio	Personalización del botón

form (Object)
prefilledAddress	Opcional	Dirección del usuario si la conocemos
prefilledCountry	Opcional	País del usuario si lo conocemos

customization (Object)
layout	Opcional	https://developer.paypal.com/sdk/js/reference/#link-layout
color	Opcional	https://developer.paypal.com/sdk/js/reference/#link-color
label	Opcional	https://developer.paypal.com/sdk/js/reference/#link-label
borderRadius	Opcional	https://developer.paypal.com/sdk/js/reference/#link-borderradius

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Crypto

Nos permitirá renderizar un botón de Crypto.

await paylandsCheckout.crypto({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Pix

Nos permitirá renderizar un botón de Pix.

await paylandsCheckout.pix({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Floa

Nos permitirá renderizar un botón de Floa.

await paylandsCheckout.floa({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Pse

Nos permitirá renderizar un botón de Pse.

await paylandsCheckout.pse({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Spei

Nos permitirá renderizar un botón de Spei.

await paylandsCheckout.spei({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Bizum

Nos permitirá renderizar un formulario de Bizum en nuestra página.

await paylandsCheckout.bizum({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
prefixLabel	Opcional	Label del input del prefijo telefónico
prefixError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledPrefix	Opcional	Prefijo del usuario si lo conocemos
prefilledPhone	Opcional	Número del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento bizum_valid.

window.addEventListener('message', event => {
    if (event.data.bizum_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.bizum_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor bizum.

button.addEventListener("click", () => window.postMessage({ pay: "bizum" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Cofidis

Nos permitirá renderizar un formulario de Cofidis en nuestra página.

await paylandsCheckout.cofidis({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento cofidis_valid.

window.addEventListener('message', event => {
    if (event.data.cofidis_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.cofidis_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor cofidis.

button.addEventListener("click", () => window.postMessage({ pay: "cofidis" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Giropay

Nos permitirá renderizar un formulario de Giropay en nuestra página.

await paylandsCheckout.giropay({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
addressLabel	Opcional	Label del input de la dirección
addressError	Opcional	Error a mostrar si el valor es incorrecto
zipCodeLabel	Opcional	Label del input del código postal
zipCodeError	Opcional	Error a mostrar si el valor es incorrecto
cityLabel	Opcional	Label del input de la ciudad
cityError	Opcional	Error a mostrar si el valor es incorrecto
countryLabel	Opcional	Label del input del país
countryError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos
prefilledAddress	Opcional	Dirección del usuario si la conocemos
prefilledZipCode	Opcional	Código postal del usuario si lo conocemos
prefilledCity	Opcional	Ciudad del usuario si la conocemos
prefilledCountry	Opcional	País del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento giropay_valid.

window.addEventListener('message', event => {
    if (event.data.giropay_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.giropay_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor giropay.

button.addEventListener("click", () => window.postMessage({ pay: "giropay" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Ideal

Nos permitirá renderizar un formulario de Ideal en nuestra página.

await paylandsCheckout.ideal({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
addressLabel	Opcional	Label del input de la dirección
addressError	Opcional	Error a mostrar si el valor es incorrecto
zipCodeLabel	Opcional	Label del input del código postal
zipCodeError	Opcional	Error a mostrar si el valor es incorrecto
cityLabel	Opcional	Label del input de la ciudad
cityError	Opcional	Error a mostrar si el valor es incorrecto
countryLabel	Opcional	Label del input del país
countryError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos
prefilledAddress	Opcional	Dirección del usuario si la conocemos
prefilledZipCode	Opcional	Código postal del usuario si lo conocemos
prefilledCity	Opcional	Ciudad del usuario si la conocemos
prefilledCountry	Opcional	País del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento ideal_valid.

window.addEventListener('message', event => {
    if (event.data.ideal_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.ideal_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor ideal.

button.addEventListener("click", () => window.postMessage({ pay: "ideal" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Klarna

Nos permitirá renderizar un formulario de Klarna en nuestra página.

await paylandsCheckout.klarna({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
addressLabel	Opcional	Label del input de la dirección
addressError	Opcional	Error a mostrar si el valor es incorrecto
zipCodeLabel	Opcional	Label del input del código postal
zipCodeError	Opcional	Error a mostrar si el valor es incorrecto
cityLabel	Opcional	Label del input de la ciudad
cityError	Opcional	Error a mostrar si el valor es incorrecto
countryLabel	Opcional	Label del input del país
countryError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos
prefilledAddress	Opcional	Dirección del usuario si la conocemos
prefilledZipCode	Opcional	Código postal del usuario si lo conocemos
prefilledCity	Opcional	Ciudad del usuario si la conocemos
prefilledCountry	Opcional	País del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento klarna_valid.

window.addEventListener('message', event => {
    if (event.data.klarna_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.klarna_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor klarna.

button.addEventListener("click", () => window.postMessage({ pay: "klarna" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

MBWay

Nos permitirá renderizar un formulario de MBWay en nuestra página.

await paylandsCheckout.mbway({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
prefixLabel	Opcional	Label del input del prefijo telefónico
prefixError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos
prefilledPrefix	Opcional	Prefijo del usuario si lo conocemos
prefilledPhone	Opcional	Número del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento mbway_valid.

window.addEventListener('message', event => {
    if (event.data.mbway_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.mbway_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor mbway.

button.addEventListener("click", () => window.postMessage({ pay: "mbway" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Multibanco

Nos permitirá renderizar un formulario de Multibanco en nuestra página.

await paylandsCheckout.multibanco({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
customization (Object)	Obligatorio	Personalización del formulario

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Sofort

Nos permitirá renderizar un formulario de Sofort en nuestra página.

await paylandsCheckout.sofort({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
addressLabel	Opcional	Label del input de la dirección
addressError	Opcional	Error a mostrar si el valor es incorrecto
zipCodeLabel	Opcional	Label del input del código postal
zipCodeError	Opcional	Error a mostrar si el valor es incorrecto
cityLabel	Opcional	Label del input de la ciudad
cityError	Opcional	Error a mostrar si el valor es incorrecto
countryLabel	Opcional	Label del input del país
countryError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos
prefilledAddress	Opcional	Dirección del usuario si la conocemos
prefilledZipCode	Opcional	Código postal del usuario si lo conocemos
prefilledCity	Opcional	Ciudad del usuario si la conocemos
prefilledCountry	Opcional	País del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento sofort_valid.

window.addEventListener('message', event => {
    if (event.data.sofort_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.sofort_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor sofort.

button.addEventListener("click", () => window.postMessage({ pay: "sofort" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Transferencia bancaria

Nos permitirá renderizar un botón de transferencia en nuestra página.

await paylandsCheckout.transfer({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Viacash

Nos permitirá renderizar un formulario de Viacash en nuestra página.

await paylandsCheckout.viacash({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento viacash_valid.

window.addEventListener('message', event => {
    if (event.data.viacash_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.viacash_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor viacash.

button.addEventListener("click", () => window.postMessage({ pay: "viacash" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Mach

Nos permitirá renderizar un formulario de Mach en nuestra página.

await paylandsCheckout.mach({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento mach_valid.

window.addEventListener('message', event => {
    if (event.data.mach_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.mach_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor mach.

button.addEventListener("click", () => window.postMessage({ pay: "mach" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Khipu

Nos permitirá renderizar un formulario de Khipu en nuestra página.

await paylandsCheckout.khipu({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento khipu_valid.

window.addEventListener('message', event => {
    if (event.data.khipu_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.khipu_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor khipu.

button.addEventListener("click", () => window.postMessage({ pay: "khipu" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Klap

Nos permitirá renderizar un formulario de Klap en nuestra página.

await paylandsCheckout.klap({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento klap_valid.

window.addEventListener('message', event => {
    if (event.data.klap_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.klap_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor klap.

button.addEventListener("click", () => window.postMessage({ pay: "klap" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

FlowPay

Nos permitirá renderizar un formulario de FlowPay en nuestra página.

await paylandsCheckout.flowpay({
    container: 'renderContainer',
    form: { ... },
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el formulario
form (Object)	Obligatorio	Configuración del formulario
customization (Object)	Obligatorio	Personalización del formulario

form (Object)
nameLabel	Opcional	Label del input del nombre
nameError	Opcional	Error a mostrar si el valor es incorrecto
lastNameLabel	Opcional	Label del input del apellido
lastNameError	Opcional	Error a mostrar si el valor es incorrecto
emailLabel	Opcional	Label del input del email
emailError	Opcional	Error a mostrar si el valor es incorrecto
phoneLabel	Opcional	Label del input del número telefónico
phoneError	Opcional	Error a mostrar si el valor es incorrecto
prefilledName	Opcional	Nombre del usuario si lo conocemos
prefilledLastName	Opcional	Apellido del usuario si lo conocemos
prefilledEmail	Opcional	Email del usuario si lo conocemos

customization (Object)
font	Opcional	Fuente de texto
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
errorColor	Opcional	Color del texto de error
borderColor	Opcional	Color del borde de los inputs
borderRadius	Opcional	Radio del borde de los inputs
padding	Opcional	Espaciado
inputTextSize	Opcional	Tamaño del texto del input
labelTextSize	Opcional	Tamaño del texto del label
iconSize	Opcional	Tamaño de los iconos
iconColor	Opcional	Color de los iconos

¿Como validar el formulario? El formulario tiene su propia validación la cual comunica mediante el evento flowpay_valid.

window.addEventListener('message', event => {
    if (event.data.flowpay_valid === true) {
        console.log('El formulario es válido');
    }
    if (event.data.flowpay_valid === false) {
        console.log('El formulario contiene errores');
    }
});

¿Como hacer submit? Enviar un evento pay con el valor flowpay.

button.addEventListener("click", () => window.postMessage({ pay: "flowpay" }));

Este evento será capturado por el SDK para procesar el pago. Una vez procesado, enviará un nuevo evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

PicPay

Nos permitirá renderizar un botón de PicPay.

await paylandsCheckout.picpay({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.

Paysafecard

Nos permitirá renderizar un botón de Paysafecard.

await paylandsCheckout.paysafecard({
    container: 'renderContainer',
    customization: { ... }
});

Request
container	Obligatorio	ID del contenedor sobre el que se renderizará el botón
customization (Object)	Obligatorio	Personalización del botón

customization (Object)
buttonText	Opcional	Contenido del botón
font	Opcional	Fuente de texto
primaryColor	Opcional	Color del botón
textColor	Opcional	Color del texto
backgroundColor	Opcional	Color del fondo
borderRadius	Opcional	Radio del borde del botón
padding	Opcional	Espaciado
buttonTextSize	Opcional	Tamaño del texto del botón

Una vez el usuario finalice el pago, se enviará un evento sobre la propia página con alguno de los siguientes valores que deberá ser tratado por el comercio:

Response
redirect	URL hacia la que redirigir al usuario con el resultado del pago OK/KO
render	Contenido HTML para renderizar en la página. Esto sucede porque se requiere la intervención del usuario de nuevo, generalmente para completar el 3DS
error	Contenido HTML con el error ocurrido.