Going Live (Switching to Production)

Getting the encryption key and API key for the Production environment

IMPORTANT: These keys are unique to each terminal and different depending on the environment (staging or live).

The encryption password is an alphanumeric code that is essential for operations with your virtual POS and is different for each environment.

The JavaScript password is a Universal Unique Identifier (UUID) that authorizes the connection and rendering of the cashier using JavaScript, which is also used by the CMS modules.

Depending on the type of integration, you will need to get one (1) or two (2) keys from the Addon Payments BackOffice Portal:

  • Integration with JavaScript or CMS module (PrestaShop, WooCommerce, Magento, Salesforce).
    • Encryption password.
    • JavaScript password.
  • Hosted or Host2Host integration:
    • Encryption password.

For security reasons, the encryption and JavaScript passwords are not sent by email. You can get them directly through the Addon Payments BackOffice Portal. To get the right passwords before starting to operate in a live environment, follow these steps:

  1. Go into the Addon Payments BackOffice Portal.
    • Click on the link or put the following URL into your browser, depending on the environment you want to go to or manage:
    • You can change the BackOffice Portal language on the login screen. Click to choose one of the language options available: Spanish (ES), English (EN) or Catalan (CA).
    • Enter your username and password. Click on “LOG IN”.
  2. At the bottom of the menu on the left, click “Merchant settings” > “Password Management”.
  3. In the “Change Checkout Password” tab, click “Recover saved password” at the bottom left.
  4. A pop-up window will open with the encryption password. Copy the password and click “Close”.

Note: If the integration is through a CMS module or JavaScript, you will also have to recover your JavaScript password. Follow these steps:

  1. Click on the “Change JavaScript Password” tab.
  2. Click “Recover saved password“.
  3. A pop-up window will open with the encryption password. Copy the password and click “Close”.

Changing JavaScript and encryption passwords

You can change your encryption and JavaScript passwords following these steps.

Changing JavaScript password

  1. Go to the "Change JavaScript Password" tab.
  2. Enter the password of your choice in the "Password" and "Confirm Password" fields. The password must meet the stated requirements (valid UUID format).
  3. Display the "Advanced settings" panel. Here you can select whether you want the password change to be instantaneous or whether you prefer both the old and new passwords to be valid for a period of five (5) minutes. This way you can update the password on your e-commerce platform without having to stop the service.
  4. If the password matches in both fields and meets the above conditions, a "Save JavaScript Password" button will appear in the bottom right corner. Click on it.
  5. When you click on the button, a pop-up window will appear informing you of the change in the password you have entered.
  6. Click "Yes" to make the change permanent.
  7. From this moment on, and unless you have changed it using the option available in "Advanced settings", you have five (5) minutes in which both the old and the new password will be functional. After five (5) minutes, you will only be able to operate your Addon Payments virtual POS with the new password.

Changing Encryption password

  1. Go to the "Change Checkout Password" tab.
  2. Enter the password of your choice in the "Password" and "Confirm Password" fields. The password must meet the requirements indicated (6-20 characters, etc).
  3. Display the "Advanced settings" panel. Here you can select whether you want the password change to be instantaneous or whether you prefer both the old and new passwords to be valid for a period of five (5) minutes. This way you can update the password on your e-commerce platform without having to stop the service.
  4. If the password matches in both fields and meets the above conditions, a "Save Checkout Password" button will appear in the bottom right corner. Click on it.
  5. When you click on the button, a pop-up window will appear informing you of the PBKDF2 With HmacSHA256 of the password entered. This code (PBKDF2 With HmacSHA256) is the one you will have to use as your new encryption key.
  6. Copy and save the new encryption password (PBKDF2 With HmacSHA256), and click "Yes" to make the change permanent.
  7. From this moment on, and unless you have changed it using the option available in "Advanced settings", you have five (5) minutes in which both the old and the new password will be functional. After five (5) minutes, you will only be able to operate your Addon Payments virtual POS with the new password.

    Set up your gateway for staging environment

    Once you’ve set up your keys and, if necessary, the JavaScript key, you have to update the settings on the payment gateway on your ecommerce platform to operate in a real environment. Depending on the type of online sales platform you have, there are different instructions.

    Hosted Integration

    1. Change the URL where requests are sent to the following one:  https://checkout.addonpayments.com/EPGCheckout/rest/online/tokenize
    2. Change the encryption password to the latest one. See section Getting the encryption key and API key for the Production environment of this guide.

    Host2Host Integration

    1. Change the URL where requests are sent to:
      https://checkout-stg.addonpayments.com/EPGCheckout/rest/online/pay
    2. Change the encryption password to the latest one. See the section Getting the encryption key and API key for the Production environment of this guide.

    JavaScript Integration

    1. Change the URL where authorization requests are sent to:
      https://epgjs-mep.addonpayments.com/auth     
    2. Change the URL where payment requests are sent to:
      https://epgjs-mep.addonpayments.com/charge/v2
    3. Change the encryption password to the latest one. See section Getting the encryption key and API key for the Production environment of this guide.
    4. Change the JavaScript password to the latest one. See section Getting the encryption key and API key for the Production environment of this guide.

      Modular platforms

      If you don’t know how to make changes on your platform, contact your integrator and ask for the specific steps to follow.

      PrestaShop

      1. Go to the settings for the Addon Payments payment module.
      2. Set the “Production mode” switch to “Enabled”.
      3. Enter the password for JavaScript in “API key”. You can get the JavaScript password in the section Getting the encryption key and API key for the Production environment of this guide.
      4. Enter the encryption password in “Password”. You can get the encryption password in the section Getting the encryption key and API key for the Production environment of this guide.
      5. Click “Save” to save the changes, at the lower right of the form.
      6. Wipe the PrestaShop cache.

      WooCommerce

      1. Go to the settings for the Addon Payments payment module.
      2. Tick the box for “Production mode”.
      3. Enter the password for JavaScript in “API key”. You can get the JavaScript password in the section Getting the encryption key and API key for the Production environment of this guide.
      4. Enter the encryption password in “Password”. You can get the encryption password in the section Getting the encryption key and API key for the Production environment of this guide.
      5. Click “Save changes” to save the changes, at the lower left of the form.

      Magento

      1. Go to the settings for the Addon Payments payment module.
      2. Open the “Credentials” panel.
      3. Enter the password for JavaScript in “Merchant key”. You can get the JavaScript password in the section Getting the encryption key and API key for the Production environment of this guide.
      4. Enter the encryption password in “Merchant Secret”. You can get the encryption password in the section Getting the encryption key and API key for the Production environment of this guide.
      5. Click on the “Sandbox” dropdown and choose “No”.
      6. Click “Save Config” at the upper right of the form to save changes.
      7. Wipe the Magento cache.

      Testing it works properly in the live environment

      When you’ve set up your payment gateway to operate in a live environment, you can check the module or development works and that your merchant info is set up correctly.

      We recommend placing two orders through your ecommerce platform using each payment solution available. Place the first order using a valid account or card and the second with an invalid account or card. Make sure your ecommerce platform correctly handles the notifications received from Addon Payments.

      For security reasons, there aren’t any cards for testing authorized operations in the live environment. You can only test authorized operations with real cards and operations.

      If you’ve completed all the steps of the integration process, your virtual POS is now operational and ready to start receiving operations.

      Comparte este documento
      Tabla de Contenidos

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

      Comienza a integrar

      undraw_add_to_cart_re_wrdo 1 (1) (1)

      Plugins para CMS

      Complementa la integración

      SDKs

      Métodos de pago

      Herramientas

      Addon Payments

      Consulta la documentación de Addon Payments. Aquí tienes las distintas secciones:

      Integraciones

      Consultas frecuentes

      Portal Backoffice

      Cyberpac

      We are currently working on the English version of the Cyberpac documentation. You can view the Spanish version using the buttons below:

      Canales BackOffice Portal

      Plugins integration

      Custom integrations

      POS integrated Payments

      Create a solution that will help you automate processes. You can even add payment processes on physical terminals.

      Payment Integrated with Android POS

      Payment Integrated with Smartphone POS

      POS Data sheets

      Addon Payments

      Comercia Global Payments has several integration options so you can choose the most efficient one for you.

      Integrations

      Frequently Asked Questions

      BackOffice Portal

      Consult the documentation of the different integrations sections:​

      Start integration

      undraw_add_to_cart_re_wrdo 1 (1) (1)

      CMS Plugins

      Complement your integration

      SDKs

      Payment Methods

      Tools