Pase a Producción

Cómo obtener la clave de cifrado y la clave API para entorno de Producción

IMPORTANTE: Las claves son únicas para cada terminal y diferentes según el entorno (Staging o Producción).

La contraseña de cifrado es un código alfanumérico imprescindible para poder realizar operaciones a través de tu TPV virtual y es diferente según el entorno.

La contraseña JavaScript es un identificador UUID único que autoriza la conexión y renderizado del cajero por JavaScript, el cual también es utilizado por los módulos para CMS.

Dependiendo del tipo de integración necesitarás obtener una (1) o dos (2) claves a través del Portal BackOffice de Addon Payments:

Integración por JavaScript o por módulo para CMS (PrestaShop, WooCommerce, Magento, Salesforce).
- Contraseña de cifrado.
- Contraseña de JavaScript.
Integración Hosted o Host2Host:
- Contraseña de cifrado.

Por motivos de seguridad, las contraseñas de cifrado y JavaScript para el entorno de Producción no se facilitan por correo electrónico. Puedes recuperarlas directamente a través del Portal BackOffice de Addon Payments. Para obtener las contraseñas correctas antes de operar en entorno de Producción, sigue estos pasos:

Accede al Portal BackOffice de Addon Payments.
- Haz clic en el enlace o introduce la URL en el navegador según el entorno que quieras consultar o gestionar:
  - Staging/Pruebas: https://smb-stg.addonpayments.com
  - Producción: https://smb.addonpayments.com
- En la pantalla de acceso puedes modificar el idioma del Portal BackOffice. Pulsa el botón para cambiar el idioma entre Español (ES), Inglés (EN) y Catalán (CA).
- Introduce tu usuario y contraseña de acceso. Pulsa en “INICIAR SESIÓN”.
En la parte inferior del menú lateral izquierdo, pulsa en “Configuración de Comercio” > “Gestión de Contraseñas”.
En la pestaña “Cambiar Contraseña de Checkout”, pulsa el botón “Recuperar Contraseña guardada”, situado en la parte inferior izquierda.
Se abrirá una ventana emergente con la contraseña de cifrado. Copia la contraseña y pulsa el botón “Cerrar”.

Nota: Si tu integración es por módulo para CMS o JavaScript también necesitarás recuperar la contraseña para JavaScript. Sigue estos pasos:

Pulsa en la pestaña “Cambiar Contraseña JavaScript”.
Pulsa en el botón “Recuperar Contraseña guardada”.
Se abrirá una ventana emergente con la contraseña de cifrado. Copia la contraseña y pulsa el botón “Cerrar”.

Cambio de contraseña de JavaScript y de cifrado

Puedes modificar las contraseñas de cifrado y JavaScript siguiendo distintos pasos.

Cambio de contraseña JavaScript

Accede a la pestaña “Cambiar Contraseña JavaScript”.
Introduce la contraseña que quieras en los campos “Contraseña” y “Confirme Contraseña”. La clave debe cumplir los requisitos indicados (formato UUID válido).
Despliega el panel “Configuración avanzada”. En él puedes seleccionar si quieres que el cambio de contraseña sea instantáneo o si prefieres que tanto la contraseña anterior como la nueva sean válidas durante un plazo de cinco (5) minutos. De esta forma puedes actualizar la contraseña en tu plataforma de comercio electrónico sin sufrir detención del servicio.
Si la contraseña coincide en ambos campos y cumple las condiciones indicadas, aparecerá el botón “Guardar Contraseña JavaScript” en la esquina inferior derecha. Haz clic en él.
Al pulsar el botón aparecerá una ventana emergente informando del cambio en la contraseña introducida.
Pulsa en “Sí” para que el cambio sea definitivo.
A partir de este momento, y salvo que lo hayas modificado mediante la opción disponible en “Configuración avanzada”, tienes cinco (5) minutos en los que tanto la contraseña antigua como la nueva serán funcionales. Pasados los cinco (5) minutos, sólo podrás operar en tu TPV virtual de Addon Payments con la contraseña nueva.

Cambio de contraseña de cifrado

Accede a la pestaña “Cambiar Contraseña de Checkout”.
Introduce la contraseña que quieras en los campos “Contraseña” y “Confirme Contraseña”. La clave debe cumplir los requisitos indicados (6-20 caracteres, etc).
Despliega el panel “Configuración avanzada”. En él puedes seleccionar si quieres que el cambio de contraseña sea instantáneo o si prefieres que tanto la contraseña anterior como la nueva sean válidas durante un plazo de cinco (5) minutos. De esta forma puedes actualizar la contraseña en tu plataforma de comercio electrónico sin sufrir detención del servicio.
Si la contraseña coincide en ambos campos y cumple las condiciones indicadas, aparecerá el botón “Guardar Contraseña Checkout” en la esquina inferior derecha. Haz clic en él.
Al pulsar el botón aparecerá una ventana emergente informando del PBKDF2 With HmacSHA256 de la contraseña introducida. Este código (PBKDF2 With HmacSHA256) es el que deberás utilizar como nueva clave de cifrado.
Copia y guarda la nueva contraseña de cifrado (PBKDF2 With HmacSHA256), y pulsa en “Sí” para que el cambio sea definitivo.
A partir de este momento, y salvo que lo hayas modificado mediante la opción disponible en “Configuración avanzada”, tienes cinco (5) minutos en los que tanto la contraseña antigua como la nueva serán funcionales. Pasados los cinco (5) minutos, sólo podrás operar en tu TPV virtual de Addon Payments con la contraseña nueva.

Configurar tu pasarela para entorno de Producción

Una vez hayas configurado las claves y, si corresponde, también la de JavaScript, es necesario actualizar la configuración de la pasarela de pago en tu plataforma de comercio electrónico para operar en entorno de Producción. Dependiendo del tipo de plataforma para venta online hay distintas indicaciones.

Integración Hosted

Cambia la URL a la que se envían las peticiones por la siguiente: https://checkout.addonpayments.com/EPGCheckout/rest/online/tokenize
Sustituye la contraseña de cifrado por la última obtenida. Consulta la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.

Integración por Host2Host

Modifica la URL a la que se envían las peticiones por:
https://checkout.addonpayments.com/EPGCheckout/rest/online/pay
Sustituye la contraseña de cifrado por la última obtenida. Consulta la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.

Integración por JavaScript

Modifica la URL a la que se envían las peticiones de autorización por:
https://epgjs-mep.addonpayments.com/auth
Modifica la URL a la que se envían las peticiones de pago por:
https://epgjs-mep.addonpayments.com/charge/v2
Sustituye la contraseña de cifrado por la última obtenida. Consulta la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Sustituye la contraseña de JavaScript por la última obtenida. Consulta la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.

Plataformas modulares

En caso de desconocer cómo realizar los cambios en tu plataforma, contacta con tu empresa integradora para solicitarle los pasos específicos a seguir.

PrestaShop

Accede a la configuración del módulo de pago de Addon Payments.
Establece el selector de “Modo de producción” a “Habilitado”.
Introduce la contraseña obtenida para JavaScript en “Clave API”. Puedes obtener la contraseña de JavaScript en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Introduce la contraseña para cifrado en “Contraseña”. Puedes obtener la contraseña de cifrado en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Pulsa el botón “Guardar” situado en la parte inferior derecha del formulario para guardar los cambios.
Vacía la memoria caché de PrestaShop.

WooCommerce

Accede a la configuración del módulo de pago de Addon Payments.
Marca la casilla de “Modo de producción”.
Introduce la contraseña para JavaScript en “API Key”. Puedes obtener la contraseña de JavaScript en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Introduce la contraseña para cifrado en “Contraseña”. Puedes obtener la contraseña de cifrado en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Pulsa el botón “Guardar los cambios” situado en la parte inferior izquierda del formulario para guardar los cambios.

Magento

Accede a la configuración del módulo de pago de Addon Payments.
Despliega el panel “Credentials”.
Introduce la contraseña para JavaScript en “Merchant Key”. Puedes obtener la contraseña de JavaScript en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Introduce la contraseña para cifrado en “Merchant Secret”. Puedes obtener la contraseña de cifrado en la sección Cómo obtener la clave de cifrado y la clave API para entorno de Producción de esta guía.
Haz clic en el desplegable “Sandbox” y pulsa la opción “No”.
Pulsa el botón “Save Config” en la parte superior derecha del formulario para guardar los cambios.
Vacía la memoria caché de Magento.

Probar el correcto funcionamiento en entorno de Producción

Cuando hayas configurado tu pasarela de pagos para operar en entorno de Producción, puedes comprobar el funcionamiento del módulo o desarrollo junto a la correcta configuración de los datos de tu comercio.

El proceso recomendado consiste en realizar dos pedidos a través de tu plataforma de comercio electrónico en cada una de las soluciones de pago disponibles. Haz el primer pedido usando una cuenta o tarjeta operativa y el segundo pedido con otra cuenta o tarjeta no operativa. Verifica que tu plataforma de comercio electrónico gestiona correctamente las notificaciones recibidas desde Addon Payments.

Por motivos de seguridad, no existe una tarjeta para hacer pruebas en operaciones autorizadas en entorno de Producción. Las pruebas de operaciones autorizadas sólo pueden realizarse con tarjetas reales y operativas.

Si has completado todos los pasos del proceso de integración, tu TPV virtual ya está operativo y listo para empezar a recibir operaciones.

Pase a Producción

Cómo obtener la clave de cifrado y la clave API para entorno de Producción