Connecting Your X-Cart Store to X-Payments Cloud
page last edited on 04 February 2020
Once the X-Payments Cloud connector addon has been installed and enabled, you can connect your store to X-Payments Cloud with it.
To access the X-Payments Cloud connection page in your X-Cart store Admin area, use one of the following methods:
Select My Addons in the sidebar menu of your X-Cart Admin area, find the installed addon “X-Payments Cloud connector” and click on the Settings link pertaining to it. The most convenient way to find the addon quickly will be to do a search via the search box using a search string like “x-payments” or “cloud”. The Settings link will be here:
Go to the payments listing page (Store setup > Payment methods), locate the payment method “X-Payments Cloud” and choose to configure it:
The page for connecting your X-Cart store to X-Payments Cloud is titled “X-Payments Cloud settings” and looks as follows:
Once you are ready to proceed with the connection, you will need to either create a new X-Payments Cloud account or to provide the connection details for your existing X-Payments Cloud account.
If you do not have an existing X-Payments Cloud account, choose to create one:
In the field Your email, specify the email address that you are going to use for the X-Payments Cloud account administrator.
In the field Account name, specify your desired account name.
After completing the above fields, click Create account.
This will initiate the creation of an X-Payments Cloud account for you and start your 14 day trial period. No commitment and no credit card are required during the trial period.
The creation of your X-Payments account is likely to take a few seconds. During this time you will see a screen as follows:
In the end you will be prompted to set a password for your X-Payments Cloud account:
Enter your desired password and type it once again for confirmation. Be sure to click Submit. For your convenience, a link to Strong password generator is provided.
After submitting your password, the connection of your store to your X-Payments Cloud account is basically completed. Now you can access the Payment processing page of your X-Payments Cloud admin panel right from your X-Cart store on the X-Payments Cloud Settings page:
You can control the availability of your X-Payments Cloud payment method and view the list of your X-Payments Cloud payment configurations without having to further authenticate yourself to X-Payments Cloud. You can even test your store’s checkout using the X-Payments Cloud payment method with X-Payments Demo Pay payment configuration.
For full featured access to X-Payments Cloud, however, you will need to complete 2-step user authentication setup for your account. As soon as you provide the details of your first real payment configuration and choose to save them, you will see a page like the following: You will need to set up 2-step user authentication to be able to continue.
Detailed information on setting up 2-step user authentication methods in X-Payments Cloud is available in the X-Payments Cloud manual.
After your X-Payments Cloud account has been created, within 15 minutes you will receive an email message with the subject “Welcome to X-Payments!”. In this message you will find a link to confirm your X-Payments Cloud registration email address. You have 24 hours to confirm your email address using that link. If the email address is not confirmed until that time, your X-Payments Cloud account will be locked. (“Locked” means that you will be able to sign in but will not have access to any sensitive information or settings).
Important: The email confirmation link expires in 24 hours. If you use the link after it has expired, you will get an error message. In this case, you will still be able to confirm your email address and unlock your account: sign in to the X-Payments Cloud admin panel, use the button “Send confirmation link” to request a new email confirmation link, wait for the email message with the confirmation link to be sent to your inbox, then use the link to confirm your email address. After this your account will be unlocked:
Your X-Payments Cloud trial will be available to you for 14 days. After this time your account will be deactivated, but not yet deleted. You will know your X-Payments Cloud trial period has expired if the X-Payments Cloud settings page in your X-Cart store Admin area looks like this:
If you purchase an X-Payments subscription within the 30 days following your trial expiration, you will regain access to your X-Payments Cloud account and all the settings you have configured in it. After the 30 day period, your account will be deleted permanently, and all the information associated with it will be lost.
Information on the available X-Payments subscription plans can be found here.
If you already have an existing X-Payments Cloud account:
Use the link “If you already have an X-Payments account, please click here” in the bottom of the X-Payments Cloud connection page to access the page for X-Payments Cloud account sign-in:
On the sign-in page, enter your account name and click Connect:
This will connect your X-Cart store to your existings X-Payments Cloud account.
When connected, you can view your X-Payments Cloud payment configurations list and enable/disable any existing payment configurations without additional authorization:
For full featured access, additional authorization will be required. For example, when you choose to add a new payment configuration, you will be prompted to specify your X-Payments Cloud account registration email address and password:
Once your X-Cart 5 store has been connected to X-Payments Cloud, you will see a screen like the following:
Here you can manage your X-Payments Cloud payment configurations. For more information on this, see Getting Started with X-Payments Cloud
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.