Quix

Introducción

Quix es el servicio de financiación «Buy Now Pay Later» de Caixabank Payments & Consumer (CPC) que conecta comercios, empresas de financiación y clientes. Puedes financiar a tus clientes de 3 a 12 meses (los meses los establece Quix y no se pueden modificar) para importes desde 50 a 1200€.

Nota: Actualmente, Quix está disponible únicamente para transacciones en Euros y clientes con nacionalidad española y que residan en territorio nacional.

Quix ofrece los siguientes servicios de integración:

Checkout widget: Un elemento visual compatible con integraciones de Addon Payments Hosted y JavaScript, que permite al cliente completar el proceso de financiación.
Simulador de cuotas: Se mostrará la información relativa a las cuotas y plazos de la financiación disponible.

Para que tus clientes puedan reconocer la solución de financiación y disfrutar las condiciones de financiación te sugerimos la siguiente configuración:

Cargar el logo de Quix en tu eCommerce (descargar recursos adjuntos)
Añadir el literal “Pagar a plazos” o equivalente, para que sea fácilmente reconocible

Tipo de pago	Financiación
Países disponibles	España
Divisas disponibles	Euro
Cantidad mínima para pagos	50€
Cantidad máxima para pagos	1200€
Extensión del pago	3 a 12 meses
¿Necesita redirección?	Sí
¿Admite pago en dos fases?	No
¿Admite devoluciones?	Sí, desde el BackOffice o mediante petición H2H

Tu plataforma de comercio electrónico debe recoger el consentimiento o informar al cliente en las condiciones de compra que sus datos personales se comunicarán a QUIX para tramitar la financiación. Este es un ejemplo de texto legal:

Si marcas esta casilla consientes que [TU COMERCIO] comunique tus datos identificativos y de contacto (nombre y apellidos, fecha de nacimiento y correo electrónico) a SEQURA WORLDWIDE S.A., que tratará tus datos como responsable del tratamiento, con la finalidad de tramitar tu financiación. Para más información sobre el tratamiento de tus datos accede a https://legal.sequra.com/politica-privacidad.

Para poder hacer uso de esta solución de pago es necesario contratar el servicio de financiación con CPC. Para información comercial o en caso de no tener contratado el servicio, puedes ponerte en contacto con tu gestor habitual de CPC o visitar el sitio web de CPC para obtener más información: https://www.caixabankpc.com/es/comercios. También puedes contactar por correo electrónico a través de digital@caixabankpc.com.

En esta guía se facilita la información necesaria para realizar la integración de la solución de pago fraccionado Quix en la pasarela de Addon Payments en las integraciones Hosted y JavaScript.

Nota: La solución de pago Quix no es compatible actualmente con la integración Host2Host.

Esta guía es complementaria a la guía básica de integración que hayas seleccionado para integrar con AP:

También tienes a tu disposición un glosario de términos y una colección Postman con las operativas de Quix:

Credenciales para pruebas de integración

Puedes usar los siguientes datos para realizar pruebas de integración de la solución de pago en tu plataforma de comercio electrónico:

DNI: 99999999R (puede usarse cualquiera).
N.º de teléfono: 600000000 (puede usarse cualquiera).
Código de validación: Las 5 últimas cifras del n.º de teléfono introducido.
Tarjeta:
- PAN: 4716773077339777
- Caducidad: 12/30
- CVV: 123

Estas credenciales funcionarán siempre y cuando la pasarela de pago esté configurada para operar en el entorno de Staging de AP. Para probar la integración en entorno de Producción necesitarás usar credenciales reales y activas.

Entornos: Staging y Producción

Addon Payments cuenta con dos (2) entornos operativos independientes:

Entorno de staging:

Es el primer entorno con el cual entrarás en contacto.
Tienes a tu disposición un listado de tarjetas para pruebas que permiten realizar transacciones simulando diferentes operativas, tipos de autenticación (frictionless, challenge) y resultados (autorizada, denegada).
Esto te permite comprobar la correcta gestión de las diferentes casuísticas por parte de tu integración.
Las tarjetas y cuentas reales no funcionan.

Entorno de producción:

Es el entorno en el cual las transacciones tienen efectos contables.
Únicamente se puede transaccionar con tarjetas y cuentas reales y operativas.

A continuación, tienes unas tablas con los endpoints a los que enviar la petición según el tipo de integración:

Entorno	URL
Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize
Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/tokenize

Petición	Entorno	URL
Petición /auth	Staging	https://epgjs-mep-stg.addonpayments.com/auth
Petición /charge	Staging	https://epgjs-mep-stg.addonpayments.com/charge/v2
Petición /auth	Producción	https://epgjs-mep.addonpayments.com/auth
Petición /charge	Producción	https://epgjs-mep.addonpayments.com/charge/v2

A continuación, tienes una tabla con la biblioteca de AP de JavaScript que debes importar y la llamada para definir la URL base de la pasarela de pago.

Debes añadir, en la página de pago de tu plataforma de comercio electrónico, un elemento HTML <script> con la ruta de la biblioteca JS de AP. Esta ruta debe incluir la versión de la biblioteca a cargar. Actualmente recomendamos la versión 4.0.0.

Función	Entorno	URL
Importar la biblioteca JS de Addon Payments	Staging	https://epgjs-rendercashier-stg.addonpayments.com/js/public/epgjs-[versión]-min.js
Definir la URL base de la pasarela de pago	Staging	https://epgjs-web-stg.addonpayments.com/
Importar la biblioteca JS de Addon Payments	Producción	https://epgjs-rendercashier.addonpayments.com/js/public/epgjs-[versión]-min.js
Definir la URL base de la pasarela de pago	Producción	https://epgjs-web.addonpayments.com/

Integración por Hosted

A continuación vamos a ver cómo realizar la integración de Quix vía Hosted.

Petición

Este es el ejemplo de petición de un comercio que realiza transacciones de artículos. Los parámetros que enviar en la petición cambian según el servicio que preste el negocio. En la sección Parámetros según servicio tienes tablas con los distintos parámetros según el servicio prestado.

Además, recomendamos que visites nuestra sección 3DSecure con el objetivo de añadir campos adicionales al proceso de pago. Estos datos opcionales enriquecen la solicitud de pago y pueden facilitar el proceso de autenticación.

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Este es un ejemplo de petición en cadena y cURL para un producto en Quix vía Hosted. Recuerda que la cadena debe pasar el proceso de cifrado, firma y envío de la petición.

				
					currency=EUR&amount=99&country=ES&customerId=903&merchantId
=116659&merchantTransactionId=79037935&paymentSolution=quix&statusURL
=https://webhook.site/359a42a8-4759-45cb-81cd-6d34e546617f&successURL
=https://test.com/success&errorURL=https://test
.com/error&cancelURL=https://test.com/cancel&awaitingURL
=https://test.com/awaiting&firstName=Name&lastName=Last Name&productId
=1166590003&customerEmail=email@micomercio.com&customerNationalId
=99999999R&customerCountry=ES&dob=1999-12-01&ipAdress=192.168.1
.1&paysolExtendedData
={"product":"instalments","billing":{"first_name":"Nombre","last_name":"Apellido","address":{"street_address":"Nombre de la vía y nº","postal_code":"08003","city":"Barcelona","country":"ESP"}},"cart":{"currency":"EUR","total_price_with_tax":99,"items":[{"article":{"name":"Nombre del servicio 2","type":"product","category":"physical","description":"Descripción artículo 2","reference":"4912345678903","unit_price_with_tax":99,"autoshipping":false},"units":2,"total_price_with_tax":99,"auto_shipping":true}]}}

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/tokenize' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: bdlDqWWCnw+aAra4vLujFA==' \
--form 'merchantId="12345"' \
--form 'encrypted="jULXEtDfSVYIgfV29GBTcibe+ED+IvnfI2ssayrpqoJRzmI+SVst1SV3LRjt7DHlU5+0FoBPZy8KfoajNYn6DwRU0ltMtgd2TsR2ccm+Aeg5NAPbMlVZZnDmWA2WUmh3sXFWDMFGcHnwigMv0dWW+0QOieFJN+NLPMo/HMhLOLNNfS9240qdT++PTx7IdtSM3hfbD31ZDgKSkxwCDQYSrcIS0LyPtRuRkMQjHNMjOzo/FNSe0dqTdRw0dI5QpoqAgFk8MEkByIiZPIK6GYzkRv9NsBrVpRw3271VPG7gDlK4+ZEkjRXJ+JQgV0QxybU4XNE1pPlB3BxzBtsr56gPEVCNrVjNQtfTwNqphT39+7GShtEUrAsKU7r+nxivGxhd/8b2ECkk/7Dk7WPLnCJPnXJrIAWzKd1wiPaTPYrMvCuxRAMYF+sk6ZPENAipntbetAbXHDVs6KKbjyCjDLRwGX7rrIlPi0TTIH9nGfPTq4DL1CDxivnjd1eOGOnHzQRr”' \
--form 'integrityCheck="0bc22b4408a6a2bf135fd2eb3832775f44b02f96d7e10d940b81c5069763685f"'

Una vez enviado el POST a Addon Payments, recibirás la URL donde redireccionar al cliente:

				
					https://checkout.stg-eu-west3.epgint.com/EPGCheckout/rest/online/detokenize?token=4b374d64-a263-43dc-bb74-c8e88257d4c2&apiVersion=5

Para conocer más sobre cuando redireccionar al cliente, visita la sección Redirección del cliente.

Parámetros de la solicitud por Hosted

El tipo indica si el parámetro es requerido/obligatorio (R) u opcional (O):

Campo	Formato	Tipo	Descripción	Ejemplo
prepayToken	Alfanumérico UUID	R (sólo en la integración JavaScript)	Se envía en la cabecera de la petición. AP devuelve esta referencia después de que el cliente introduzca sus datos en el formulario de pago de JS. Es la referencia que enlaza con los datos de la tarjeta o cuenta del cliente para integración JavaScript.	97fe3726-adb1-4e24-9fb8-92593a75ae74
merchantId	Numérico entero 4~7 dígitos	R	Es el indicador de tu comercio en la plataforma de AP. Es facilitado por Soporte en el correo de bienvenida, es común para los dos entornos	14983
productId	Numérico entero 6~11 dígitos	R	Identificador del producto creado en tu comercio en AP. Es facilitado en el correo de bienvenida.	149830
paymentSolution	Alfanumérico Valor admitido: – quix	R	Nombre de la solución de pago por la cual debe procesarse la transacción. En este caso es «quix»	quix
merchantTransactionId	Alfanumérico Máx. 45 caracteres	R	Es el identificador único de la transacción del comercio. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente.	pedido_91684
amount	Numérico decimal 0~1000000.00	R	Importe de la transacción. Si el importe tiene decimales, el separador es un punto (.). No se puede incluir el separador en los millares	127.5
currency	Alfabético 3 caracteres ISO-4217.3	R	Divisa de la transacción	EUR
country	Alfabético 2 caracteres ISO 3166-1 alfa-2	R	País desde el que se envía la transacción	ES
customerId	Alfanumérico Máx. 80 caracteres	R	Id. del cliente en tu plataforma de comercio electrónico. Para clientes sin registro recomendamos el envío de un id de cliente progresivo diferente al de los clientes registrados. Por ejemplo, identificadores A000000 para clientes registrados y B000000 para los no registrados.	A34623
statusURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma de comercio electrónico donde AP enviará la notificación con el estado de la transacción. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/status
successURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es autorizada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/success
errorURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es denegada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/error
cancelURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si cancela la transacción durante el proceso de pago. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/cancel
awaitingURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si la transacción está pendiente de procesar. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/awaiting
firstName	Alfabético Máximo 100 caracteres	R	Nombre del cliente. Si tiene más de uno se separan con espacios.	Pablo
lastName	Alfabético Máximo 100 caracteres	R	Apellido(s) del cliente Es obligatorio enviar los 2 apellidos separados por un espacio. Si no se envían los dos, el widget de Quix se lo solicitará	Ferrer Calas
customerEmail	Alfabético Máximo 100 caracteres	R	Correo electrónico del cliente.	correo@mail.com
customerCountry	Código ISO 3166-1 Alfa-2 «ES»	R	País del cliente. Actualmente sólo está disponible España.	ES
customerNationalId	Alfanumérico Máximo 100 caracteres	R	Número del DNI (con letra) en caso de clientes españoles.	40404040A
dob	Alfanumérico Máximo 10 caracteres. AAAA-MM-DD	R	Fecha de nacimiento del cliente. Si no se envía, se lo solicitará el widget. Quix sólo está disponible para mayores de edad.	1990-01-01
ipAddress	Alfanumérico Máximo 45 caracteres. Formato IPv4 o IPv6	R	Dirección IP del cliente.	192.158.1.38
operationType	Alfanumérico Máx. 45 caracteres	O	Especifica el tipo de operación a realizar. Valores admitidos: – debit (por defecto): Transacción de pago. Es decir, el efectivo viaja desde la cuenta del cliente al comercio. – credit: Transacción de ingreso en cuenta del cliente. Es decir, el efectivo viaja desde el comercio hasta la cuenta del cliente. Por ejemplo, en el pago de un premio. No confundir con las devoluciones. Estas tienen su propio tipo de transacción.	debit
paymentMethod	Valor aceptado: – «instalments»	O	Sub método de la solución de pago.	instalments
telephone	Alfanumérico Máximo 45 caracteres	O	Número de teléfono. Debe incluir el prefijo internacional.	+34600600600
language	ISO 639-1 -ES -EN	O	Idioma para mostrar la pasarela de pago al cliente. Sólo está disponible el castellano y el inglés.	ES
paysolExtendedData	Los parámetros que contiene están en las siguientes tablas.	R	Objeto JSON que contiene información extra del cliente, facturación y carrito.	N/A

Parámetros según servicio

A continuación, tienes tablas con los parámetros necesarios según el servicio que preste tu negocio. El tipo indica si son requeridos (R) u opcionales (O). Todos estos parámetros van dentro de «paysolExtendedData».

Nota: Estas tablas tienen parámetros que son objetos JSON que contienen otros parámetros dentro. Los puedes distinguir por su color más oscuro, además, se indican algunos de los campos que contienen. Puedes ver de forma más clara la estructura en la sección de los JSON.

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero para los pagos. Aunque se envíe, el cliente podrá seleccionar la frecuencia de los meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name – last_name – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
– total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
– currency	ISO-4217	R	Moneda en ISO-4217	EUR
– reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
– items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	product
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− description	Alfanumérico	O	Descripción del artículo.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del artículo.	23.50
−−− brand	Alfanumérico	O	marca o fabricante del artículo.	Marca
−−− mpn	Alfanumérico	O	código del artículo del fabricante.	8234F
shipping	Objeto. Puede contener: – name – first_name – last_name – company – email – phone_number – address	O	Objeto JSON que contiene información extra del envío.	N/A
− name	Alfanumérico	O	Nombre de la empresa de transportes.	Empresa S.L.
− first_name	Alfanumérico	O	Nombre del destinatario del envío.	Pablo
− last_name	Alfanumérico	O	Apellido(s) del destinatario del envío.	Ferrer
− company	Alfanumérico	O	Nombre de la empresa del destinatario del envío.	Empresa S.A.
− email	Alfanumérico	O	Correo electrónico del destinatario del envío.	email@correo.es
− phone_number	Alfanumérico +34XXXXXXXXX	O	Número de teléfono del destinatario del envío. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	+34600600600 Codificado: %2B34600600600
− method	Alfanumérico home: envío a domicilio digital: envío digital postal: recogida en Correos pick_up_point: punto de recogida pick_up_store: recogida en tienda pick_up_warehouse: recogida en almacén own: método propio click_collect: recogida en tienda	O	Método de envío del producto o servicio.	home
− address	Objeto. Debe contener estos campos: – street_address – street_address_2 – postal_code – city – country	O	Objeto JSON que contiene información extra de la dirección de envío.	N/A
−− street_address	Alfanumérico	O	Tipo de vía, nombre de la vía y n.º de la vía de envío.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de envío.	3 F
−− postal_code	Alfanumérico	O	Código postal de la población de envío.	08003
−− city	Alfanumérico	O	Ciudad de envío.	Barcelona
−− country	Alfanumérico	O	País de envío.	ESP

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name: – last_name: – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax – end_date	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	service
−−− end_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha de fin del servicio. La fecha de fin del servicio debe ser superior a la fecha de la petición y a la fecha de inicio del servicio. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-12-31T23:59:59+01:00 Codificado: 2023-12-31T23:59:59%2B01:00%2B
−−− start_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	O	Fecha de inicio del servicio IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-01-01T00:00:00+01:00 Codificado: 2023-01-01T00:00:00%2B01:00
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− description	Alfanumérico	O	Descripción del servicio.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del servicio.	23.50

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name – last_name – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	flight
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− departure_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora del despegue. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-01-01T00:00:00+01:00 Codificado: 2023-01-01T00:00:00%2B01:00
−−− passengers	Objeto. Debe contener un JSON con estos campos obligatorios por cada pasajero: – first_name – last_name	R	Objeto JSON que contiene información de los pasajeros.	N/A
−−−− first_name	Alfanumérico	R	Nombre del pasajero	Pablo
−−−− last_name	Alfanumérico	R	Apellido del pasajero	Ferrer
−−− segments	Objeto. Debe contener un JSON con estos campos obligatorios por cada pasajero: – iata_departure_code – iata_destination_code	R	Objeto JSON que contiene información de los puntos de salida y llegada	N/A
−−−− iata_departure_code	Alfanumérico	R	Código iata del aeropuerto de salida	MAD
−−−− iata_destination_code	Alfanumérico	R	Código iata del aeropuerto de llegada	BCN

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name: – last_name: – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax – checkin_date – checkout_date – establishment_name – guests	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	accommodation
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− checkin_date	YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora de entrada. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2024-01-01T16:00:00+00:00 Codificado: 2024-01-01T16:00:00%2B00:00
−−− checkout_date	YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora de salida. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2024-01-06T12:00:00+00:00 Codificado: 2024-01-06T12:00:00%2B00:00
−−− establishment_name	Alfanumérico	R	Nombre del alojamiento	Hotel 2
−−− guests	Numérico entero	R	Número de húespedes	2
−−− description	Alfanumérico	O	Descripción del artículo.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del artículo.	23.50
−−− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra del alojamiento	N/A
−−−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º del alojamiento	Calle canales 2
−−−− street_address_2	Alfanumérico	O	Planta y número de puerta del alojamiento	3 F
−−−− postal_code	Alfanumérico	R	Código postal de la población del alojamiento	08003
−−−− city	Alfanumérico	R	Ciudad del alojamiento	Barcelona
−−−− country	Alfanumérico	R	País del alojamiento	ESP

JSON según servicio

A continuación, tienes JSON de ejemplo con los parámetros básicos (sin cifrar) según servicio:

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

				
					[merchantId] => 12345
[productId] => 14983
[merchantTransactionId] => 13035363
[amount] => 99
[currency] => EUR
[country] => ES
[customerId] => 1
[paymentSolution] => quix
[statusURL] => https://test.com/status
[successURL] => https://test.com/success
[errorURL] => https://test.com/error
[cancelURL] => https://test.com/cancel
[awaitingURL] => https://test.com/awaiting
[firstName] => Nombre
[lastName] => Apellido
[customerEmail] => nombre.apellido@correo.com
[customerNationalId] => 99999999R
[customerCountry] => ES
[dob] => 1981-10-01
[ipAddress] => 192.168.1.1
[paysolExtendedData] => {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Apellido",
        "address": {
            "street_address": "Nombre de la vía y nº",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.00,
        "items": [{
                "article": {
                    "name": "Producto físico",
                    "type": "product",
                    "category": "physical",
                    "reference": "4912345678903",
                    "unit_price_with_tax": 49.50
                },
                "units": 2,
                "total_price_with_tax": 99.00,
                "auto_shipping": true
            },
        ]
    }
};

				
					[merchantId] => 12345
[productId] => 14983
[merchantTransactionId] => 13035363
[amount] => 99.99
[currency] => EUR
[country] => ES
[customerId] => 1
[paymentSolution] => quix
[statusURL] => https://test.com/status
[successURL] => https://test.com/success
[errorURL] => https://test.com/error
[cancelURL] => https://test.com/cancel
[awaitingURL] => https://test.com/awaiting
[firstName] => Nombre
[lastName] => Apellido
[customerEmail] => nombre.apellido@correo.com
[customerNationalId] => 99999999R
[customerCountry] => ES
[dob] => 1981-10-01
[ipAddress] => 192.168.1.1
[paysolExtendedData] => {
   "product":"instalments",
   "billing":{
      "first_name":"Nombre",
      "last_name":"Apellido",
      "address":{
         "street_address":"Nombre de la vía y nº",
         "postal_code":"08003",
         "city":"Barcelona",
         "country":"ESP"
      }
   },
   "cart":{
      "currency":"EUR",
      "total_price_with_tax":99.99,
      "items":[
         {
            "article":{
               "name":"Nombre del servicio",
               "type":"service",
               "category":"digital",
               "reference":"4912345678904",
               "unit_price_with_tax":99.99,
               "end_date":"2023-12-31T23:59:59+01:00" // El símbolo "+" de este parámetro debe someterse a URL Encode
            },
            "units":1,
            "total_price_with_tax":99.99,
            "auto_shipping": true
         }
      ]
   }
};

				
					[merchantId] => 12345
[productId] => 14983
[merchantTransactionId] => 13035363
[amount] => 99.99
[currency] => EUR
[country] => ES
[customerId] => 1
[paymentSolution] => quix
[statusURL] => https://test.com/status
[successURL] => https://test.com/success
[errorURL] => https://test.com/error
[cancelURL] => https://test.com/cancel
[awaitingURL] => https://test.com/awaiting
[firstName] => Nombre
[lastName] => Apellido
[customerEmail] => nombre.apellido@correo.com
[customerNationalId] => 99999999R
[customerCountry] => ES
[dob] => 1981-10-01
[ipAddress] => 192.168.1.1
[paysolExtendedData] => {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Last Name",
        "address": {
            "street_address": "Nombre de la vía y n 13",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
        }
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.99,
        "items": [{
            "article": {
                "name": "Vuelo MAD - BCN",
                "type": "flight",
                "category": "digital",
                "reference": "4912345678904",
                "unit_price_with_tax": 99.99,
                "departure_date": "2024-01-01T00:00:00+01:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "passengers": [{
                    "first_name": "Nombre1",
                    "last_name": "Apellido1",
                }, ],
                "segments": [{
                    "iata_departure_code": "MAD",
                    "iata_destination_code": "BCN",
                }],

            },
            "units": 1,
            "total_price_with_tax": 99.99,
            "auto_shipping": true
        }]
    }
};

				
					[merchantId] => 12345
[productId] => 14983
[merchantTransactionId] => 13035363
[amount] => 99.99
[currency] => EUR
[country] => ES
[customerId] => 1
[paymentSolution] => quix
[statusURL] => https://test.com/status
[successURL] => https://test.com/success
[errorURL] => https://test.com/error
[cancelURL] => https://test.com/cancel
[awaitingURL] => https://test.com/awaiting
[firstName] => Nombre
[lastName] => Apellido
[customerEmail] => nombre.apellido@correo.com
[customerNationalId] => 99999999R
[customerCountry] => ES
[dob] => 1981-10-01
[ipAddress] => 192.168.1.1
[paysolExtendedData] => {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Apellido",
        "address": {
            "street_address": "Nombre de la vía y nº",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
        }
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.99,
        "items": [{
            "article": {
                "name": "Alojamiento",
                "type": "accommodation",
                "category": "physical",
                "reference": "4912345678904",
                "unit_price_with_tax": 99.99,
                "checkin_date": "2024-01-01T16:00:00+00:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "checkout_date": "2024-01-06T12:00:00+00:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "establishment_name": "Hotel Ejemplo",
                "address": {
                    "street_address": "Tipo, nombre y n.º de la vía",
                    "postal_code": "00000",
                    "city": "Madrid",
                    "country": "ESP"
                },
                "guests": 3
            },
            "units": 1,
            "total_price_with_tax": 99.99,
            "auto_shipping": true
        }]
    }
};

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Este es un ejemplo de respuesta de pago definitiva para un producto:

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response operation-size="1">
	<message>Quix callback response has finished successfully, for the transaction Id: 7737819</message>
	<operations>
		<operation sorted-order="1">
			<amount>99.0</amount>
			<currency>EUR</currency>
			<details>{"order_id":"13214d8b-6380-414c-b018-339f9e426048","event":"order_capture_created","triggered_at":"2023-11-23T13:54:13+00:00","order_reference_1":"59376738","order_reference_2":"7737819","description":"Capture auto-generated by auto shipping","captured_amount":99,"captured_items":[{"id":"ac11140a-4cfd-40f9-a93e-2f3973266af7","total_discount":{"currency":"EUR","amount":0},"total_price_with_tax":{"currency":"EUR","amount":99},"units":2,"article":{"id":"b03fc588-4f76-484c-9fe4-5ce789b5da6a","type":"online_product","name":"Nombre del servicio 2","category":"physical","price":{"currency":"EUR","amount":99},"reference":"4912345678903","description":"Descripcin articulo 2"}}]}</details>
			<merchantTransactionId>59376738</merchantTransactionId>
			<message>Transaction change to SUCCESS.</message>
			<operationType>DEBIT</operationType>
			<paymentSolution>quix</paymentSolution>
			<status>SUCCESS</status>
			<transactionId>7737819</transactionId>
			<respCode>
				<code>0000</code>
				<message>Successful</message>
				<uuid>22da7b17_3644_4cdf_8645_2ae23c2e13bc</uuid>
			</respCode>
		</operation>
	</operations>
	<optionalTransactionParams/>
	<status>SUCCESS</status>
	<workFlowResponse>
		<id>389281</id>
		<name>BNPL</name>
		<version>0</version>
	</workFlowResponse>
</response>

Integración por JavaScript

En esta sección encontrarás cómo integrar Quix mediante JavaScript.

Obtención del authToken

El primer paso es obtener el «authToken» que nos permitirá renderizar el cajero. Se debe mandar una petición con los datos que mostramos a continuación:

				
					{   
    "merchantId": "12345",
    "merchantKey": "dd0bc115-6f8f-4e65-9447-e06862eb62ec",
    "productId": "123450001",
    "currency": "EUR",
    "country": "ES",
    "customerId": "customer25879",
    "operationType": "debit"
}

				
					curl --location 'https://epgjs-mep-stg.addonpayments.com/auth' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "12345",
    "merchantKey": "dd0bc115-6f8f-4e65-9447-e06862eb62ec",
    "productId": "123450001",
    "currency": "EUR",
    "country": "ES",
    "customerId": "customer25879",
    "operationType": "DEBIT"
}'

Si la petición es válida, Addon Payments te devolverá un «authToken» con el que podrás renderizar el cajero en el frontal de tu página. Si la petición no es válida, se devolverá un mensaje como el que ves en la segunda pestaña:

				
					{
    "authToken": "50fe7cab-63c4-4197-9484-50f9a0792f8b"
}

				
					{
    "error": true,
    "errorMessage": "Invalid merchant id or merchant key",
    "errorCode": 400
}

Tu plataforma debe almacenar este código para continuar con el siguiente paso. Las referencias de autorización recibidas tienen las siguientes características:

Validez de 30 minutos.
Puede ser usada varias veces para enlazar la pasarela de pago.

Renderizar el cajero de Quix mediante JavaScript

Antes de llamar a la función de enlazado de la pasarela de pago (window[‘EPGJS’].renderIntegratedCashier), debes realizar algunos pasos previos para que la solución de pago funcione correctamente:

1. Debes establecer el «setMerchantPrePayCallback», una función que recibirá la llamada al endpoint de cobro del servicio mep de EPGJS:

window['EPGJS_COMM'].setMerchantPrePayCallback(prepayCallback);

2. Debes renderizar el cajero en el frontal. Este es un código de ejemplo:

				
					<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <title>JS render cashier</title>
    <style>
        #render-cashier {
            width: 350px;
            margin-top: 100px;
            border: 1px solid #ccc;
            padding: 20px;
            text-align: center;
        }
    </style>
</head>

<body>
    <div id="epgjs-cashier-div"></div>
    <script src="https://epgjs-rendercashier-stg.easypaymentgateway.com/js/public/epgjs-4.0.0-min.js"></script>
    <script>
        var authtoken = "5bb1dfd6-7692-47c3-beaf-2326fd74ee89"; // Add here your authToken
        function prePayCallback(prepayData) {
            // Show prepayToken This is just for example purposes only and should not be shown to your customer
            alert(JSON.stringify(prepayData, null, 2));
        }
        function displayingMessageOnButtonClick() {
            EPGJS_COMM.setEpgBaseUrl('https://epgjs-web-stg.easypaymentgateway.com/');
            EPGJS.renderIntegratedCashier(authtoken, 'epgjs-cashier-div', 'quix');
            EPGJS_COMM.setMerchantPrePayCallback(prePayCallback);
            window['EPGJS'].setInitPaysolParam({ "product": "instalments", "amount": 7000, "currency": "EUR", "locale": "es-ES", "decimalSeparator": ".", "thousandSeparator": ",", "style": "width: 100%", "styleBranding": "lending_hub", "styleVariant": "select", "styleColor": "#34aeeb" });
        }
        window.onload = displayingMessageOnButtonClick;
    </script>
</body>
</html>

3. La función de inicialización «setInitPaysolParam» se compone de un JSON con los parámetros de la tabla. En la llamada a la función tienes como formarlos.

Campo	Formato y valores admitidos	Tipo	Descripción
product	instalments	R	Producto financiero a aplicar en el widget de financiación.
amount	Numérico entero. Ejemplo, 123,45 sería: 12345	R	importe de financiación a calcular (producto/carrito) en céntimos.
currency	EUR	R	Código ISO-4217 de la divisa del importe. Actualmente, sólo es válido el euro.
locale	Alfanumérico Formato RFC 1766 es-ES en-UK	R	Idioma del cliente. Actualmente sólo está disponible el español y el inglés.
decimalSeparator	. ,	R	Símbolo para separar los decimales en los importes. En España el símbolo decimal es el la coma (,).
thousandSeparator	. ,	R	Símbolo para separar los millares en los importes. En España el símbolo millar es el punto (.)
styleBranding	lending_hub	R	Versión del widget a cargar, lo cual modifica los componentes visuales y los textos legales mostrados. Facilitado por Quix.
style	width: 100%	R	Estilos a aplicar en el widget de financiación. Se debe enviar el valor de la columna de formato.
styleVariant	text select text_banner select_banner	R	Tipo de widget a cargar.
styleColor	Hexadecimal #RRGGBB #34aeeb	R	Color de algunos elementos.
language	es en	O	Idioma en el que se mostrará el widget al cliente. Actualmente sólo están el español y el inglés.

				
					window['EPGJS'].setInitPaysolParam({ "product": "instalments", "amount": 7000, 
"currency": "EUR", "locale": "es-ES", "decimalSeparator": ".", 
"thousandSeparator": ",", "style": "width: 100%", "styleBranding": 
"lending_hub", "styleVariant": "select", "styleColor": "#34aeeb" });

Charge

Con el cajero renderizado y la función «prepayCallback» establecida, se puede realizar un charge. Estos son los parámetros para hacerlo, el tipo indica si son requeridos u opcionales:

Campo	Formato	Tipo	Descripción	Ejemplo
prepayToken	Alfanumérico UUID	R (sólo en la integración JavaScript)	Se envía en la cabecera de la petición. AP devuelve esta referencia después de que el cliente introduzca sus datos en el formulario de pago de JS. Es la referencia que enlaza con los datos de la tarjeta o cuenta del cliente para integración JavaScript.	97fe3726-adb1-4e24-9fb8-92593a75ae74
merchantId	Numérico entero 4~7 dígitos	R	Es el indicador de tu comercio en la plataforma de AP. Es facilitado por Soporte en el correo de bienvenida, es común para los dos entornos	14983
productId	Numérico entero 6~11 dígitos	R	Identificador del producto creado en tu comercio en AP. Es facilitado en el correo de bienvenida.	149830
paymentSolution	Alfanumérico Valor admitido: – quix	R	Nombre de la solución de pago por la cual debe procesarse la transacción. En este caso es «quix»	quix
merchantTransactionId	Alfanumérico Máx. 45 caracteres	R	Es el identificador único de la transacción del comercio. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente.	pedido_91684
amount	Numérico decimal 0~1000000.00	R	Importe de la transacción. Si el importe tiene decimales, el separador es un punto (.). No se puede incluir el separador en los millares	127.5
currency	Alfabético 3 caracteres ISO-4217.3	R	Divisa de la transacción	EUR
country	Alfabético 2 caracteres ISO 3166-1 alfa-2	R	País desde el que se envía la transacción	ES
customerId	Alfanumérico Máx. 80 caracteres	R	Id. del cliente en tu plataforma de comercio electrónico. Para clientes sin registro recomendamos el envío de un id de cliente progresivo diferente al de los clientes registrados. Por ejemplo, identificadores A000000 para clientes registrados y B000000 para los no registrados.	A34623
statusURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma de comercio electrónico donde AP enviará la notificación con el estado de la transacción. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/status
successURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es autorizada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/success
errorURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona al cliente si la transacción es denegada. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/error
cancelURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si cancela la transacción durante el proceso de pago. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/cancel
awaitingURL	Alfanumérico (caracteres permitidos en URL) Máx. 2048 caracteres	R	URL de tu plataforma a la que se redirecciona el cliente si la transacción está pendiente de procesar. Si se envía en la petición, tendrá prioridad sobre la configurada en el Portal BackOffice de Addon Payments. Si no se envía en la petición, se redirigirá al cliente a la URL configurada en el módulo de administración.	https://www.example.com/awaiting
firstName	Alfabético Máximo 100 caracteres	R	Nombre del cliente. Si tiene más de uno se separan con espacios.	Pablo
lastName	Alfabético Máximo 100 caracteres	R	Apellido(s) del cliente Es obligatorio enviar los 2 apellidos separados por un espacio. Si no se envían los dos, el widget de Quix se lo solicitará	Ferrer Calas
customerEmail	Alfabético Máximo 100 caracteres	R	Correo electrónico del cliente.	correo@mail.com
customerCountry	Código ISO 3166-1 Alfa-2 «ES»	R	País del cliente. Actualmente sólo está disponible España.	ES
customerNationalId	Alfanumérico Máximo 100 caracteres	R	Número del DNI (con letra) en caso de clientes españoles.	40404040A
dob	Alfanumérico Máximo 10 caracteres. AAAA-MM-DD	R	Fecha de nacimiento del cliente. Si no se envía, se lo solicitará el widget. Quix sólo está disponible para mayores de edad.	1990-01-01
ipAddress	Alfanumérico Máximo 45 caracteres. Formato IPv4 o IPv6	R	Dirección IP del cliente.	192.158.1.38
operationType	Alfanumérico Máx. 45 caracteres	O	Especifica el tipo de operación a realizar. Valores admitidos: – debit (por defecto): Transacción de pago. Es decir, el efectivo viaja desde la cuenta del cliente al comercio. – credit: Transacción de ingreso en cuenta del cliente. Es decir, el efectivo viaja desde el comercio hasta la cuenta del cliente. Por ejemplo, en el pago de un premio. No confundir con las devoluciones. Estas tienen su propio tipo de transacción.	debit
paymentMethod	Valor aceptado: – «instalments»	O	Sub método de la solución de pago.	instalments
telephone	Alfanumérico Máximo 45 caracteres	O	Número de teléfono. Debe incluir el prefijo internacional.	+34600600600
language	ISO 639-1 -ES -EN	O	Idioma para mostrar la pasarela de pago al cliente. Sólo está disponible el castellano y el inglés.	ES
paysolExtendedData	Los parámetros que contiene están en las siguientes tablas.	R	Objeto JSON que contiene información extra del cliente, facturación y carrito.	N/A

Parámetros según servicio

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero para los pagos. Aunque se envíe, el cliente podrá seleccionar la frecuencia de los meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name – last_name – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
– total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
– currency	ISO-4217	R	Moneda en ISO-4217	EUR
– reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
– items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	product
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− description	Alfanumérico	O	Descripción del artículo.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del artículo.	23.50
−−− brand	Alfanumérico	O	marca o fabricante del artículo.	Marca
−−− mpn	Alfanumérico	O	código del artículo del fabricante.	8234F
shipping	Objeto. Puede contener: – name – first_name – last_name – company – email – phone_number – address	O	Objeto JSON que contiene información extra del envío.	N/A
− name	Alfanumérico	O	Nombre de la empresa de transportes.	Empresa S.L.
− first_name	Alfanumérico	O	Nombre del destinatario del envío.	Pablo
− last_name	Alfanumérico	O	Apellido(s) del destinatario del envío.	Ferrer
− company	Alfanumérico	O	Nombre de la empresa del destinatario del envío.	Empresa S.A.
− email	Alfanumérico	O	Correo electrónico del destinatario del envío.	email@correo.es
− phone_number	Alfanumérico +34XXXXXXXXX	O	Número de teléfono del destinatario del envío. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	+34600600600 Codificado: %2B34600600600
− method	Alfanumérico home: envío a domicilio digital: envío digital postal: recogida en Correos pick_up_point: punto de recogida pick_up_store: recogida en tienda pick_up_warehouse: recogida en almacén own: método propio click_collect: recogida en tienda	O	Método de envío del producto o servicio.	home
− address	Objeto. Debe contener estos campos: – street_address – street_address_2 – postal_code – city – country	O	Objeto JSON que contiene información extra de la dirección de envío.	N/A
−− street_address	Alfanumérico	O	Tipo de vía, nombre de la vía y n.º de la vía de envío.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de envío.	3 F
−− postal_code	Alfanumérico	O	Código postal de la población de envío.	08003
−− city	Alfanumérico	O	Ciudad de envío.	Barcelona
−− country	Alfanumérico	O	País de envío.	ESP

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name: – last_name: – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax – end_date	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	service
−−− end_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha de fin del servicio. La fecha de fin del servicio debe ser superior a la fecha de la petición y a la fecha de inicio del servicio. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-12-31T23:59:59+01:00 Codificado: 2023-12-31T23:59:59%2B01:00%2B
−−− start_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	O	Fecha de inicio del servicio IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-01-01T00:00:00+01:00 Codificado: 2023-01-01T00:00:00%2B01:00
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− description	Alfanumérico	O	Descripción del servicio.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del servicio.	23.50

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name – last_name – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	flight
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− departure_date	Alfanumérico YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora del despegue. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2023-01-01T00:00:00+01:00 Codificado: 2023-01-01T00:00:00%2B01:00
−−− passengers	Objeto. Debe contener un JSON con estos campos obligatorios por cada pasajero: – first_name – last_name	R	Objeto JSON que contiene información de los pasajeros.	N/A
−−−− first_name	Alfanumérico	R	Nombre del pasajero	Pablo
−−−− last_name	Alfanumérico	R	Apellido del pasajero	Ferrer
−−− segments	Objeto. Debe contener un JSON con estos campos obligatorios por cada pasajero: – iata_departure_code – iata_destination_code	R	Objeto JSON que contiene información de los puntos de salida y llegada	N/A
−−−− iata_departure_code	Alfanumérico	R	Código iata del aeropuerto de salida	MAD
−−−− iata_destination_code	Alfanumérico	R	Código iata del aeropuerto de llegada	BCN

Campo	Formato	Tipo	Descripción	Ejemplo
product	Alfanumérico	R	Tipo de fraccionamiento a realizar. Actualmente el tipo de fraccionamiento disponible es “instalments “, que permite fraccionar el pago entre 10 y 12 meses. El valor del parámetro “paymentMethod» tiene prioridad sobre el enviado en esta clave.	instalments
period	Numérico entero Máximo 2 dígitos	O	Indica los meses que se seleccionan por defecto en el cajero de pago para realizar los cobros. Aunque se envíe, el cliente podrá seleccionar la frecuencia de meses.	3
disableFormEdition	Booleano: – true (bloquea campos) – false (no bloquea campos)	O	Bloquea los campos informados en la petición (Nombre, apellidos, etc.) para que no se puedan modificar en el formulario de financiación por el cliente.	true
confirmation_cart_data	Objeto. Puede contener estos campos: – url	O	Objeto JSON con información extra del carrito.	N/A
− url	Alfanumérico	O	URL de tu plataforma de comercio electrónico donde Quix puede consultar sobre posibles cambios en la información del carrito. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://micomercio.com/url_verificacion_carrito.php Codificado: https%3A%2F%2Fmicomercio.com%2Furl_verificacion_carrito.php
customer	Objeto. Puede contener estos campos – locale – userAgent	O	Objeto JSON con información extra del cliente.	N/A
− locale	RFC-1766 – es – en	O	Idioma del cliente en la plataforma de comercio en formato RFC-1766.	es
− userAgent	Alfanumérico Máximo 256 caracteres	O	Agente de usuario del navegador del cliente. Se obtiene de «navigator.userAgent».	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/114.0
− title	Alfanumérico	O	Título del cliente (Sr., Sra., etc).	Sr.
− document_expiration_date	Alfanumérico AAAA-MM-ddTHH:mm:ss	O	Fecha de caducidad del documento de identidad.	2030-12-31T00:00:00
− logged_in	Booleano – true – false	O	Indica si el cliente está registrado en la plataforma. «true» si está registrado, «false» si no.	true
billing	Objeto. Debe contener estos campos: – first_name: – last_name: – address	R	Objeto JSON que contiene información extra de la facturación.	N/A
− first_name	Alfanumérico	R	Nombre del cliente para facturación.	Pablo
− last_name	Alfanumérico	R	Apellido del cliente para facturación.	Ferrer
− corporate_id_number	Alfanumérico	O	Número de identificación fiscal de la empresa a la cual se emite la factura. En España es el CIF. Debe enviarse un CIF válido.	U73536757
− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra de la dirección de facturación.	N/A
−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º de la vía de facturación.	Calle canales 2
−− street_address_2	Alfanumérico	O	Planta y n.º de puerta de facturación	3 F
−− postal_code	Alfanumérico	R	Código postal de la población de facturación.	08003
−− city	Alfanumérico	R	Ciudad de facturación	Barcelona
−− country	Alfanumérico	R	País de facturación	ESP
cart	Objeto. Debe contener estos campos: – total_price_with_tax – currency – items	R	Objeto JSON que contiene información extra del carrito.	N/A
− total_price_with_tax	Numérico decimal (se usa el punto como separador decimal). NNN.nn	R	Importe total del carrito. Debe coincidir con el «amount».	123.45
− currency	ISO-4217	R	Moneda en ISO-4217	EUR
− reference	Alfanumérico	O	Identificador del carrito en tu plataforma de comercio electrónico. Útil para que Quix identifique reintentos de pago con diferentes datos de cliente para un mismo carrito.	76t7y7sau8y398y
− items	Objeto. Debe contener estos campos: – article – units – total_price_with_tax – auto_shipping	R	Objeto JSON con atributos dentro. Los comercios dados de alta como «Servicios» sólo podrán incluir 1 artículo por petición.	N/A
−− units	Numérico entero	R	Número de unidades del artículo	2
−− total_price_with_tax	Numérico decimal NNN.nn	R	Importe total de las unidades del artículo. Debe coincidir con el número de unidades multiplicado por su valor.	246.90
−− auto_shipping	Booleano – false – true	R	Indica si el producto se envía automáticamente tras la recepción de la autorización.	true
−− article	Objeto. Debe contener estos campos: – name – type – category – reference – unit_price_with_tax – checkin_date – checkout_date – establishment_name – guests	R	Objeto JSON que contiene información extra de un producto o servicio del carrito.	N/A
−−− name	Alfanumérico	R	Nombre del artículo o servicio.	Artículo 2
−−− type	Valores aceptados: – «product»: producto – «service»: servicio – «accommodation»: alojamiento -«flight»: vuelo	R	Tipología del artículo o servicio	accommodation
−−− category	Valores aceptados: -«physical»: artículo físico -«digital»: artículo digital -«gift_card»: tarjeta de regalo -«discount»: descuento -«shipping_fee»: costes de envío -«sales_tax»: impuesto -«store_credit_surcharge»: recargo por crédito	R	Categoría del artículo o servicio	physical
−−− reference	Alfanumérico	R	Referencia del artículo en tu plataforma de comercio electrónico	1234A
−−− unit_price_with_tax	Numérico decimal NNN.nn	R	Importe unitario del artículo	123.45
−−− checkin_date	YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora de entrada. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2024-01-01T16:00:00+00:00 Codificado: 2024-01-01T16:00:00%2B00:00
−−− checkout_date	YYYY-MM-DDTHH:mm:ss+HH:mm	R	Fecha y hora de salida. IMPORTANTE: Las fechas y los teléfonos deben de tener el símbolo «+» con URL encode.	2024-01-06T12:00:00+00:00 Codificado: 2024-01-06T12:00:00%2B00:00
−−− establishment_name	Alfanumérico	R	Nombre del alojamiento	Hotel 2
−−− guests	Numérico entero	R	Número de húespedes	2
−−− description	Alfanumérico	O	Descripción del artículo.	Ordenador
−−− url	Alfanumérico	O	URL del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2 Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− image_url	Alfanumérico	O	URL de la imagen del producto o servicio en tu plataforma. IMPORTANTE: Las URL deben ir codificadas con URL Encode.	https://www.micomercio.com/articulo2/imagen.jpg Codificado: https%3A%2F%2Fwww.micomercio.com%2Farticulo2
−−− total_discount	Numérico decimal NNN.nn	O	Importe total de los descuentos aplicados a todas las unidades del artículo.	23.50
−−− address	Objeto. Debe contener estos campos: – street_address – postal_code – city – country	R	Objeto JSON que contiene información extra del alojamiento	N/A
−−−− street_address	Alfanumérico	R	Tipo de vía, nombre de la vía y n.º del alojamiento	Calle canales 2
−−−− street_address_2	Alfanumérico	O	Planta y número de puerta del alojamiento	3 F
−−−− postal_code	Alfanumérico	R	Código postal de la población del alojamiento	08003
−−−− city	Alfanumérico	R	Ciudad del alojamiento	Barcelona
−−−− country	Alfanumérico	R	País del alojamiento	ESP

JSON según servicio

A continuación, tienes JSON de ejemplo con los parámetros básicos (sin cifrar) según servicio:

				
					{
  "currency": "EUR",
  "amount": 99.00,
  "country": "ES",
  "customerId": "1",
  "merchantId": "12345",
  "merchantTransactionId": "13035363",
  "paymentSolution": "quix",
  "statusURL": "https://test.com/status",
  "successURL": "https://test.com/success",
  "errorURL": "https://test.com/error",
  "cancelURL": "https://test.com/cancel",
  "awaitingURL": "https://test.com/awaiting",
  "firstName": "Nombre",
  "lastName": "Apellido",
  "productId": "14893",
  "customerEmail": "nombre.apellido@correo.com",
  "customerNationalId": "99999999R",
  "customerCountry": "ES",
  "dob": "1981-10-01",
  "ipAdress": "192.168.1.1",
  "paysolExtendedData": {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Apellido",
        "address": {
            "street_address": "Nombre de la vía y nº",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
        }
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.00,
        "items": [{
                "article": {
                    "name": "Producto físico",
                    "type": "product",
                    "category": "physical",
                    "reference": "4912345678903",
                    "unit_price_with_tax": 49.50
                },
                "units": 2,
                "total_price_with_tax": 99.00,
                "auto_shipping": true
            },
        ]
    }
};

				
					{
  "currency": "EUR",
  "amount": 99.99,
  "country": "ES",
  "customerId": "1",
  "merchantId": "12345",
  "merchantTransactionId": "13035363",
  "paymentSolution": "quix",
  "statusURL": "https://test.com/status",
  "successURL": "https://test.com/success",
  "errorURL": "https://test.com/error",
  "cancelURL": "https://test.com/cancel",
  "awaitingURL": "https://test.com/awaiting",
  "firstName": "Nombre",
  "lastName": "Apellido",
  "productId": "14893",
  "customerEmail": "nombre.apellido@correo.com",
  "customerNationalId": "99999999R",
  "customerCountry": "ES",
  "dob": "1981-10-01",
  "ipAdress": "192.168.1.1",
  "paysolExtendedData": {
   "product":"instalments",
   "billing":{
      "first_name":"Nombre",
      "last_name":"Apellido",
      "address":{
         "street_address":"Nombre de la vía y nº",
         "postal_code":"08003",
         "city":"Barcelona",
         "country":"ESP"
      }
   },
   "cart":{
      "currency":"EUR",
      "total_price_with_tax":99.99,
      "items":[
         {
            "article":{
               "name":"Nombre del servicio",
               "type":"service",
               "category":"digital",
               "reference":"4912345678904",
               "unit_price_with_tax":99.99,
               "end_date":"2023-12-31T23:59:59+01:00" // El símbolo "+" de este parámetro debe someterse a URL Encode
            },
            "units":1,
            "total_price_with_tax":99.99,
            "auto_shipping": true
         }
      ]
   }
};

				
					{
  "currency": "EUR",
  "amount": 99.99,
  "country": "ES",
  "customerId": "1",
  "merchantId": "12345",
  "merchantTransactionId": "13035363",
  "paymentSolution": "quix",
  "statusURL": "https://test.com/status",
  "successURL": "https://test.com/success",
  "errorURL": "https://test.com/error",
  "cancelURL": "https://test.com/cancel",
  "awaitingURL": "https://test.com/awaiting",
  "firstName": "Nombre",
  "lastName": "Apellido",
  "productId": "14893",
  "customerEmail": "nombre.apellido@correo.com",
  "customerNationalId": "99999999R",
  "customerCountry": "ES",
  "dob": "1981-10-01",
  "ipAdress": "192.168.1.1",
  "paysolExtendedData": {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Last Name",
        "address": {
            "street_address": "Nombre de la vía y n 13",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
        }
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.99,
        "items": [{
            "article": {
                "name": "Vuelo MAD - BCN",
                "type": "flight",
                "category": "digital",
                "reference": "4912345678904",
                "unit_price_with_tax": 99.99,
                "departure_date": "2024-01-01T00:00:00+01:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "passengers": [{
                    "first_name": "Nombre1",
                    "last_name": "Apellido1",
                }, ],
                "segments": [{
                    "iata_departure_code": "MAD",
                    "iata_destination_code": "BCN",
                }],

            },
            "units": 1,
            "total_price_with_tax": 99.99,
            "auto_shipping": true
        }]
    }
};

				
					{
  "currency": "EUR",
  "amount": 99.99,
  "country": "ES",
  "customerId": "1",
  "merchantId": "12345",
  "merchantTransactionId": "13035363",
  "paymentSolution": "quix",
  "statusURL": "https://test.com/status",
  "successURL": "https://test.com/success",
  "errorURL": "https://test.com/error",
  "cancelURL": "https://test.com/cancel",
  "awaitingURL": "https://test.com/awaiting",
  "firstName": "Nombre",
  "lastName": "Apellido",
  "productId": "14893",
  "customerEmail": "nombre.apellido@correo.com",
  "customerNationalId": "99999999R",
  "customerCountry": "ES",
  "dob": "1981-10-01",
  "ipAdress": "192.168.1.1",
  "paysolExtendedData": {
    "product": "instalments",
    "billing": {
        "first_name": "Nombre",
        "last_name": "Apellido",
        "address": {
            "street_address": "Nombre de la vía y nº",
            "postal_code": "08003",
            "city": "Barcelona",
            "country": "ESP"
        }
    },
    "cart": {
        "currency": "EUR",
        "total_price_with_tax": 99.99,
        "items": [{
            "article": {
                "name": "Alojamiento",
                "type": "accommodation",
                "category": "physical",
                "reference": "4912345678904",
                "unit_price_with_tax": 99.99,
                "checkin_date": "2024-01-01T16:00:00+00:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "checkout_date": "2024-01-06T12:00:00+00:00", // El símbolo "+" de este parámetro debe someterse a URL Encode
                "establishment_name": "Hotel Ejemplo",
                "address": {
                    "street_address": "Tipo, nombre y n.º de la vía",
                    "postal_code": "00000",
                    "city": "Madrid",
                    "country": "ESP"
                },
                "guests": 3
            },
            "units": 1,
            "total_price_with_tax": 99.99,
            "auto_shipping": true
        }]
    }
};

Primera respuesta

La respuesta al charge incluye, entre otros, estos parámetros: «nemuruCartHash» y «nemuruAuthToken». El «status» de esta respuesta queda como «AWAITING_PAYSOL», lo que indica que la transacción aún no ha finalizado.

				
					<payfrex-response operation-size="1">
    <message>WorkFlow has finished successfully, for transaction Id: 463689</message>
    <operations>
      <operation sorted-order="1">
        <amount>10.0</amount>
        <currency>EUR</currency>
        <details>{"orderId":"250fefd6-024b-4efb-bb20-c64315ced79e","authToken":"l2PH2noUxxrf702ZMpet8fJbGwtz2vJV"}</details>
        <merchantTransactionId>687259596</merchantTransactionId>
        <message>Transaction was awaiting paysol.</message>
        <operationType>DEBIT</operationType>
        <optionalTransactionParams/>
        <payFrexTransactionId>463689</payFrexTransactionId>
        <paymentDetails>
          <extraDetails>
            <entry>
              <key>nemuruAuthToken</key>
              <value>l2PH2noUxxrf702ZMpet8fJbGwtz2vJV</value>
            </entry>
            <entry>
              <key>nemuruCartHash</key>
              <value>250fefd6-024b-4efb-bb20-c64315ced79e</value>
            </entry>
          </extraDetails>
        </paymentDetails>
        <paymentSolution>nemuru</paymentSolution>
        <status>AWAITING_PAYSOL</status>
      </operation>
    </operations>
    <status>SUCCESS</status>
    <workFlowResponse>
      <id>4975</id>
      <name>NEMURU PAY</name>
      <version>1</version>
    </workFlowResponse>
</payfrex-response>

Para mostrar el widget de Quix, y con los datos anteriores, llamas a la siguiente función. (1)

Opcional: Si has mandado el parámetro «disableFormEdition», debes llamar a la siguiente función. Además, su valor vendrá en el extraDetails de la respuesta anterior. (2)

1: window['NEMURU'].checkoutNemuru(nemuruAuthToken, nemuruCartHash);

2 (opcional): window['NEMURU'].checkoutNemuru(nemuruAuthToken, nemuruCartHash, disableFormEdition);

Cuando el proceso del widget finalice, se llamará a esta función del comercio:

window['NEMURU'].setStatusCallback(merchantFunction);

Segunda respuesta

Con el widget de Quix cargado, el cliente deberá rellenar todos sus datos para completar la transacción. Si se completa con éxito, recibirás una notificación indicando el estado de la operación:

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payfrex-response operation-size="1">
	<message>Quix callback response has finished successfully, for the transaction Id: 7737903</message>
	<operations>
		<operation sorted-order="1">
			<amount>200.0</amount>
			<currency>EUR</currency>
			<details>{"order_id": "f18a5ea7-afa2-47ad-b4cc-e1b326c9a67a", "event": "order_capture_created", "triggered_at": "2023-11-23T14:32:02+00:00", "order_reference_1": "26031079", "order_reference_2":"7737903", "description": "Capture auto-generated by auto shipping", "captured_amount":200, "captured_items":[{"id":"6c92 ef42-5f5d-45f7-a075-38cd126d682c", "total_discount":{"currency":"EUR", "amount":0},"total_price_with _tax":{"currency":"EUR", "amount":200},"units": 1, "article":{"id": "bfd6dc77-8153-49dc-ac67-fffabd18f f69", "type": "online_product", "name":"Nombre del servicio", "category":"physical", "price":{"currency ":"EUR", "amount":200}, "reference":"4912345678904"}}]}</details>
			<merchantTransactionId>26031079</merchantTransactionId>
			<message>Transaction change to SUCCESS.</message>
			<operationType>DEBIT</operationType>
			<transactionId>7737903</transactionId>
			<paymentSolution>quix</paymentSolution>
			<status>SUCCESS</status>
			<respCode>
				<code>0000</code>
				<message>Successful</message>
				<uuid>22da7b17_3644_4cdf_8645_2ae23c2e13bc</uuid>
			</respCode>
		</operation>
	</operations>
	<optionalTransactionParams/>
	<status>SUCCESS</status>
	<workFlowResponse>
		<id>389281</id>
		<name>BNPL</name>
		<version>0</version>
	</workFlowResponse>
</payfrex-response>

Devoluciones en Quix

Puedes realizar devoluciones en Quix de 2 formas:

1. A través del Portal BackOffice de AP:

Puedes encontrar más información sobre cómo gestionar transacciones mediante el Portal de Addon Payments en la guía Consulta de operaciones en el Portal BackOffice.
Importante: Al pulsar en devolver en el BackOffice una transacción de Quix, aparecerá un pop-up de Quix mostrando el importe del pedido y los artículos del mismo. Para la devolución, debes seleccionar los artículos y pulsar en ‘Devolver productos’.
Al finalizar una operación secundaria a través del panel BackOffice, AP enviará una notificación a tu plataforma con el tipo de operación y su importe a la URL de notificación indicada en «statusURL», en la petición de la transacción original. Puedes habilitar que tu plataforma de comercio electrónico gestione estas notificaciones y actualice el estado de las operaciones.

2. Mediante el envío de una petición a un endpoint. Estas son las URLs de conexión establecidas para ello:

Entorno	URL
Staging	https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/rebate
Producción	https://checkout.addonpayments.com/EPGCheckout/rest/online/rebate

Addon Payments permite realizar devoluciones del importe de una transacción. Para que la devolución sea posible, la transacción debe cumplir las siguientes condiciones:

La fecha de la transacción original debe ser inferior a un (1) año.
La suma de los importes de todas las devoluciones realizadas sobre la transacción original no puede exceder su importe.
Debe estar en estado autorizada y liquidada (SUCCESS).
No es posible realizar devoluciones sobre transacciones en los estados:
- No liquidadas (PENDING).
- Anuladas (VOIDED).
- Denegadas (FAIL).
- Erróneas (ERROR).

Las devoluciones no pueden ser anuladas, por lo que debes estar seguro de que, tanto la transacción como el importe a devolver, son correctos.

Petición

Recuerda que las peticiones enviadas a Addon Payments deben ser cifradas. Visita nuestra sección de Cifrado, firma y envío de la petición para más información.

Tu plataforma de comercio electrónico envía la petición de devolución generada a la URL establecida para las devoluciones (cadena y cURL).

				
					amount=600&merchantTransactionId=76543210&paymentSolution=quix&transactionId=289868

				
					curl --location --request POST 'https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/rebate' \
--header 'apiVersion: 5' \
--header 'encryptionMode: CBC' \
--header 'iv: Z7VA6TpG9B84X9x9qqXoWQ==' \
--form 'merchantId="12345"' \
--form 'encrypted="4xUYxJxLc/ABCyqJfwttTalkds3YeijsJe6MlTnC6mgmbm0aXKwhI7thwa70o6lLyjrUtW8fFNUWf/l3jIojR4H5nW54Pl+GxerG1/AjMFpHlacchB3+kfkZzko42dQKk7MopAALi6SAFbl1Uq//qsESz8fV07ED7IvRQwlXREZDFtxQn2m9eyPr5zrJczILhRx27p3lqFQ61Sqlq0nCN+3sgJmuPUMKRqlXhYqf+vErv+fBaZMPV/8iKgERJLpIjPn+HZSLpc+q5VBcD4b+rGAgEKNi56Ni/MPCpKVWBUv8HFb06PngrLfiXcnFTfNeegg0XPkkmuGwR1l1y/k1tv9dPrdBkSIwE2OuHYvrkrn+NAOTHBxjGR4Ap93aZEwcPX9afkHkFOMi/5e3JdoxtFvSwOCe1ScEw2vRDhonE+5lV7jwOrqSMr+tfWVGPqzrYj/DZiQwCIUQJM6g5x+ocLTAURzz4IiJ26kBlQpYVnedKEVhevNJNZ88z6m50W2THtDR70pQq6qjF37NCfOeq/UDCg0RB/MPfYUJRUIsfPk=' \
--form 'integrityCheck="1c256f5b834e5db6d5f453043a8a3830859b308f297cc2cf423064510c5c9b72"'

Parámetros de la solicitud de devolución

Estos son los parámetros a enviar para una petición de devolución en Quix. La columna tipo indica si el campo es requerido/obligatorio (R) u opcional (O).

Campo	Formato	Tipo	Descripción	Ejemplo
transactionId	Numérico entero Máx. 100 dígitos	R	Identificador de la transacción original sobre la cual va a realizarse la devolución.	76543210
paymentSolution	Alfanumérico Máx. 45 caracteres	R	Nombre de la solución de pago por la cual ha sido procesada la transacción inicial. Se indica en la respuesta de la transacción original.	quix
merchantTransactionId	Máx. 45 caracteres Página de códigos Latin-1 (ISO-8859-1)	R	Identificador de la transacción en tu plataforma de comercio electrónico. Sirve para que tu plataforma enlace las notificaciones recibidas con el pedido del cliente. No puede repetirse entre transacciones.	pedido_91684
amount	Numérico decimal 0~1000000.00	R	Importe de la transacción. Si el importe contiene decimales, debe usar el punto (.) como separador No se puede incluir separador de millares.	600
operationType	Alfanumérico Máx. 45 caracteres	O	Especifica el tipo de operación a realizar. Valores admitidos: – debit (por defecto): Transacción de pago. Es decir, el efectivo viaja desde la cuenta del cliente al comercio. – credit: Transacción de ingreso en cuenta del cliente. Es decir, el efectivo viaja desde el comercio hasta la cuenta del cliente. Por ejemplo, en el pago de un premio. No confundir con las devoluciones. Estas tienen su propio tipo de transacción.	debit
description	Máx. 1000 caracteres Página de códigos Latin-1 (ISO-8859-1)	O	Descripción de la transacción. Se guarda en los detalles de la transacción y se devuelve en la notificación. No afecta a la transacción, sirve para que puedas realizar una mejor identificación.	Captura después de entregar producto

Respuesta

Visita nuestra sección de Recepción y gestión de las notificaciones para conocer su estructura.

Este es un ejemplo de respuesta a una petición de devolución en Quix:

				
					<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payfrex-response operation-size="1">
    <operations>
        <operation sorted-order="1">
            <amount>600</amount>
            <currency>EUR</currency>
            <details>
                {
                  "authToken": "R1e0HcNHQ9DVwBOWmwasjHSgnevemRXd"
                }
            </details>
            <merchantTransactionId>202310021130</merchantTransactionId>
            <message>Transaction amount refunded succesfully</message>
            <operationType>REFUND</operationType>
            <optionalTransactionParams/>
            <originalAmount>600.0</originalAmount>
            <originalCurrency>EUR</originalCurrency>
            <originalPayFrexTransactionId>289867</originalPayFrexTransactionId>
            <transactionId>289868</transactionId>
            <paymentSolution>quix</paymentSolution>
            <remainingAmount>0.0</remainingAmount>
            <status>SUCCESS</status>
            <respCode>
                <code>0000</code>
                <message>Successful</message>
                <uuid>650fca40_9512_42a1_b9c8_e4e512187b88</uuid>
            </respCode>
        </operation>
    </operations>
    <status>SUCCESS</status>
</payfrex-response>

Renderizado de la calculadora de financiación (opcional)

Quix ofrece la posibilidad de cargar mediante JavaScript un simulador o calculadora de cuotas (simulation widget) en cualquier parte de tu plataforma de comercio electrónico (en la ficha del producto, en el resumen del carrito, etc.). En este simulador o calculadora de cuotas se mostrará al cliente la información relativa a las cuotas y plazos de la posible financiación:

Datos necesarios

Para mostrar el simulador de pagos fraccionados a tus clientes, deberás formar un JSON con las siguientes claves y valores:

Valor	Descripción	Tamaño y formatos admitidos
product	Producto financiero a usar para calcular la financiación. Sólo hay un valor habilitado actualmente.	instalments
amount	Importe de financiación a calcular (producto/carrito) en céntimos.	Numérico entero. Por ejemplo, 123,45 sería: 12345
currency	Código ISO-4217 de la divisa del importe. La única divisa activada actualmente es el Euro	Alfabético. EUR
clientId	Identificador de tu comercio en la plataforma Quix. Te lo facilita CPC tras el alta en el servicio.	Alfanumérico. Formato UUID
locale	Idioma del widget para el cliente. Sólo está disponible actualmente el inglés y el español	Formato RCF 1766 es-ES en-UK
decimalSeparator	Símbolo para separar los decimales en los importes. En España el símbolo decimal es el la coma (,).	, .
thousandSeparator	Símbolo para separar los millares en los importes. En España el símbolo millar es el punto (.)	, .
styleColor	Personaliza el color usado en el widget para resaltar ciertos elementos.	Alfanumérico código HTML hexadecimal #RRGGBB
styleVariant	Tipo de widget a cargar.	Alfanumérico – text – select – text_banner – select_banner
styleBranding	Versión del widget a cargar, lo cual modifica los componentes visuales y los textos legales mostrados. El valor a enviar es facilitado por Quix.	Alfanumérico Por defecto: «lending_hub»

Renderizado con JavaScript

Para cargar correctamente el banner de simulación, tu plataforma de comercio electrónico debe realizar los siguientes pasos:

Importar la biblioteca de AP para la solución de pago Quix disponible en la siguiente URL:

- https://epgjs-rendercashier.easypaymentgateway.com/js/paysol-js/nemuru/nemuru-widget-module.js
- Puedes usar este código para importar la biblioteca de AP para Quix:

<script src="https://epgjs-rendercashier.easypaymentgateway.com/js/paysol-js/nemuru/nemuru-widget-module.js"></script>

2. Generar un JSON con los parámetros indicados en el punto anterior:

				
					{
"product": "instalments",
"amount": 66000,
"currency": "EUR",
"clientId": "2af35701-d4d0-4475-80f8-1e82ab45a1a3",
"locale" : "es-ES",
"decimalSeparator" : ",",
"thousandSeparator" : ".",
"styleColor": "#34aeeb",
"styleVariant" : "select",
"styleBranding" : "lending_hub"
}

3. Llamar a la función NEMURUWIDGET.renderSimulationWidget() incluida en la biblioteca importada, incluyendo los siguientes parámetros:

- El token de autenticación “authToken» de AP.
  - Puedes consultar los detalles para obtener este token de autorización en el punto “Envío de la petición de autenticación» de la guía de integración por JavaScript.
- El JSON generado anteriormente.
- El identificador del elemento HTML “div» donde desea insertar el banner de simulación.
- Este es un ejemplo de llamada a la función:

window['NEMURUWIDGET'].renderSimulationWidget(authToken, jsonData, 'identificador_div', “Quix");

Proceso de pago

Esta es la experiencia del cliente con la solución de pago Quix en AP:

Carga del cajero

Si en la petición enviada por tu plataforma no se ha indicado que el cajero debe limitarse únicamente a la solución de pago “Quix”, cuando el navegador web del cliente carga el cajero de AP, el cliente tendrá acceso a todas las soluciones de pago que tenga activadas el producto de tu comercio en AP. El cliente tendrá que seleccionar la solución de pago “Quix” de la lista para iniciar la solicitud de financiación:

Si en la petición enviada por tu plataforma se ha indicado que el cajero debe limitarse únicamente a la solución de pago “Quix”, cuando el navegador web del cliente carga el cajero de AP, el cliente únicamente tendrá acceso a dicha solución de pago:

A continuación tienes el proceso de pago con Quix, al final tienes una galería con imágenes ilustrando cada punto:

Al pulsar en “Continuar”, AP carga el widget de simulación de Quix, el cual es independiente del tipo de integración, y donde el cliente puede:
- Seleccionar entre los diferentes plazos de financiación disponibles (3, 10 y 12 meses).
- Ver el detalle de las mensualidades, con fechas e importes de cobro.
- Ver el detalle del coste total de la financiación para el cliente.
- Ver el TIN y TAE aplicados.
Si el cliente acepta la financiación propuesta, pulsa en “Continuar” y pasa a la siguiente fase de la solicitud. En esta fase tendrá que introducir, en caso de que no aparezcan ya rellenados, los siguientes datos:
- Nombre.
- Apellidos (es obligatorio introducir 2 apellidos).
- Fecha de nacimiento.
- N.º de DNI (debe incluir letra).
- N.º de teléfono móvil (debe ser español).
Tras pulsar “Continuar”, la financiera enviará un código de verificación de cinco cifras por SMS al n.º de teléfono del cliente que tendrá que introducir en la siguiente pantalla.
El cliente introduce el código recibido por SMS:
- En caso de que el cliente no lo haya recibido, puede pulsar en “Volver a enviar” para reintentar la recepción.
- Cuando la pasarela está configurada para operar en entorno de Stage no se envía código por SMS. En su lugar, el código de validación son las 5 últimas cifras del n.º de teléfono introducido.
Al pulsar “Continuar”, al cliente se le vuelven a presentar:
- El detalle del coste total de la financiación.
- El TIN y TAE aplicados.
- Un desplegable con el detalle de las mensualidades, con fechas e importes de cobro.
El cliente debe marcar la casilla “Entiendo y acepto la política de privacidad” para poder continuar el proceso.
Al pulsar “Continuar” se pasa a la pantalla en la cual la financiera solicita que el cliente introduzca los datos de su tarjeta de crédito. En la tarjeta introducida se cargarán tanto el pago inicial como los sucesivos.
- Cuando la integración de tu plataforma de comercio electrónico está configurada para operar en entorno de Stage , en esta pantalla se mostrará una tarjeta que te permitirá realizar operaciones autorizadas en dicho entorno, con el fin de probar la integración en tu plataforma.
  - Dicha tarjeta no se muestra ni funcionará una vez modifiques la configuración de tu plataforma para operar en entorno de Producción.
Al pulsar en el botón “Pagar”, AP procesa el pago de la primera mensualidad en la tarjeta del cliente.
Si el pago finaliza correctamente, aparecerá una ventana informativa que vuelve a informar al cliente de los pagos y fechas de la financiación concedida.
Los pagos sucesivos serán cargados por el importe y en la fecha indicados en la tarjeta del cliente.

5 y 6

Quix

Introducción

Credenciales para pruebas de integración

Entornos: Staging y Producción

Integración por Hosted

Petición

Parámetros de la solicitud por Hosted

Parámetros según servicio

JSON según servicio

Respuesta

Integración por JavaScript

Obtención del authToken

Renderizar el cajero de Quix mediante JavaScript

Charge

Parámetros según servicio

JSON según servicio

Primera respuesta

Segunda respuesta

Devoluciones en Quix

Petición

Parámetros de la solicitud de devolución

Respuesta

Renderizado de la calculadora de financiación (opcional)

Datos necesarios

Renderizado con JavaScript

Proceso de pago

Tabla de Contenidos

Productos

Ventas

Soporte técnico

Socios

SmartWiki, Impulsada por IA

Quix

Introducción

Credenciales para pruebas de integración

Entornos: Staging y Producción

Integración por Hosted

Petición

Parámetros de la solicitud por Hosted

Parámetros según servicio

JSON según servicio

Respuesta

Integración por JavaScript

Obtención del authToken

Renderizar el cajero de Quix mediante JavaScript

Charge

Parámetros según servicio

JSON según servicio

Primera respuesta

Segunda respuesta

Devoluciones en Quix

Petición

Parámetros de la solicitud de devolución

Respuesta

Renderizado de la calculadora de financiación (opcional)

Datos necesarios

Renderizado con JavaScript

Proceso de pago

Tabla de Contenidos

Productos

Ventas

Soporte técnico

Socios

SmartWiki, Impulsada por IA

Cyberpac

Consulta la documentación de las distintas secciones de integraciones:

Addon Payments

Pagos integrados en TPV