Skip to main content

FOR OUR EXISTING CUSTOMERS

Your next chapter.
Alignet One.

If you use our previous platform, this guide walks you through the change: prepare your store, configure the new gateway and validate your first payment.

Start the migration I need assistance ↗

WordPress / WooCommerce · 5 guided stages

Your previous platformAlignet One

YOUR PATH TO ALIGNET ONE

FROMVPOSClassic version
TOAlignet OneYour new integration
01
Prepare your storeBackup and environment review
02
Register the merchantCode, Client ID and Client Secret
03
Install the integrationNew Alignet One plugin
04
Configure accessEnvironment, currency and credentials
05
Validate your first paymentTesting and order review

Guided path for WordPress / WooCommerce

This path is for WordPress / WooCommerce. If you use PrestaShop, VTEX, Web Checkout or an SDK, coordinate the migration procedure for your channel with Alignet before applying these steps.

Plan the change with a backup and a low-traffic window. Do not assume installation is instant or will not interrupt checkout. Coordinate validation with your team and Alignet.
1

Prepare the update

Confirm the following before making changes to the store:

New gateway file

Have the .zip file provided by Alignet ready. Do not unzip it.

Site backup

Include site files and the database. Also retain a copy of the previous plugin and its configuration so you can recover the installation.

Administrator access

The user must be able to install and remove WordPress plugins.

Low-traffic window

Avoid peak sales periods while making the change.

Merchant registration data

Have the information required to register the merchant in Alignet Command Center available.
Do not continue without a backup. You must be able to recover the site if the installation does not finish correctly.

Stage outcomeComplete backup, ZIP and access ready.

2

Merchant registration data

The plugin configuration values are generated when the merchant registration is completed in Alignet Command Center.
  1. Sign in to Alignet Command Center with an authorized account.
  2. Complete the merchant registration with the corresponding information.
  3. When registration is complete, immediately save the three values shown in the confirmation.
Use the values for the merchant and environment you are configuring. Do not assume credentials from the previous platform are valid on Alignet One.
Save the credentials before continuing. The Client ID and Client Secret are displayed when merchant registration is completed and will not be shown again. Store them securely and do not include them in screenshots, public documents, or support requests.

Stage outcomeMerchant code, Client ID and Client Secret stored securely.

3

Install the new plugin

  1. Go to Plugins → Add Plugin → Upload Plugin.
  2. Select the .zip file and click Install Now.
  3. Activate Alignet Gateway and confirm that it appears as active.
  4. Only then, deactivate and remove the previous WooCommerce plugin.
The order is important. Do not remove the previous version until you verify that Alignet Gateway is installed and active.
Alignet Gateway active and the previous plugin ready to be removed
Alignet Gateway is active; the previous version is deactivated and ready to be removed.

Stage outcomeNew gateway active and previous version removed during the change window.

4

Enter the credentials

  1. Open Payments in the WordPress sidebar.
  2. Find Alignet Gateway, confirm that it is active, and select Manage.
  3. Complete the configuration using the values saved when the merchant was registered in Alignet Command Center.
  4. Review the environment, currency, and display mode. Then click Save changes.
Configure the following values for each enabled currency:
Field mapping. Enter code as Merchant Code, then copy the Client ID and Client Secret into the fields with the same names. Complete the block for the currency you are configuring.
Payments option in the WordPress sidebar
1. Open Payments.
Manage option for Alignet Gateway
2. Select Manage in Alignet Gateway.
General Alignet Gateway configuration
3. Review the country, environment, and display mode.
Credential fields by currency in Alignet Gateway
4. Complete the credentials for each currency and save the changes.

Stage outcomeEnvironment, currency and credentials saved.

5

Validate before finishing

The migration is complete when the configuration and payment flow work correctly.
  • Configuration status: Client ID, Client Secret, and Merchant Code appear as configured.
  • Assisted test: perform a test or sandbox checkout with support from the bank and Alignet.
  • Error log: open WooCommerce → Status → Logs and confirm there are no Alignet errors.
  • Change control: record the date, versions, and person responsible.

    Stage outcomeCheckout tested, logs reviewed and change documented.

​
If something does not go as expected

Do not mark the migration as complete or enable payments before validating the result. Keep the backup and change records; coordinate recovery with Alignet. Avoid restoring the database without reviewing orders or payments recorded after the backup.When requesting help, share the plugin version, environment, date, operation number and error message. Do not send Client Secret, tokens or full card details.

Request assistance

Coordinate registration, configuration and validation questions with our team.

WooCommerce guide

Review installation, configuration and transaction management in Alignet One.