Tips for a smooth Install of X-Payments

DogByteMan · #1 07-04-2010, 04:31 AM

First, you must meet the specified server requirements.

Tip 1: Unarchive files in a new directory such as /my_pay_dir/
After unarchived, copy down contents of /my_pay_dir/xpayments/ to /my_pay_dir/ and delete /xpayments/.

If you instead decide to unarchive at root, be sure to backup your robots.txt file.

Tip 2: Wrap all entries in config with ""

Examples: host="localhost", unix_socket="", host="mail.yourdomain.com", web="https://yourdomain.com/my_pay_dir/", and yes even auth="LOGIN"

Tip 3: the real directions for:

8. IMPORTANT. Default codes contained in <lib/XPay/Model/Codebook.php> must be changed after the installation is done. Use maintenance script regen-codebook.php to generate a new codebook.

is

(Must be ran from shell)
3. Run the script with a -run flag (php regen-codebook.php -run <system path to X-Payments>).
4. If the script failed, copy the file <lib/XPay/Model/Codebook.prev.php> to the file <lib/XPay/Model/Codebook.php>, restore the database from the saved dump and repeat step 3.
5. If the script completed successfully delete the database dump file and the <lib/XPay/Model/Codebook.prev.php> file.

Tip 4: I have posted how to install X-Payments Connector for X-Cart 4.1.12 here

Please add your contributions too

DogByteMan · #2 07-04-2010, 06:00 AM

Tips for configuring the connector.

In your X-Cart under modules click configure for X-Payments Connector

Store ID: < This is the store ID that was assigned when you set up the store in X-Payments >

X-Payments URL: https://domain where X-Payments is/X-Payments Directory (NO Trailing /)(must be https)

Public key: < This is the public key that was assigned when you set up the store in X-Payments >

Private key: < This is the private key that was assigned when you set up the store in X-Payments >

Private key password: < This is the private key password that was assigned when you set up the store in X-Payments >

IP addresses for X-Payments callbacks: IP of server hosting X-Payments

photo · #3 06-18-2012, 05:20 AM

Quote:

Originally Posted by DogByteMan

8. IMPORTANT. Default codes contained in <lib/XPay/Model/Codebook.php> must be changed after the installation is done. Use maintenance script regen-codebook.php to generate a new codebook.

is

(Must be ran from shell)
3. Run the script with a -run flag (php regen-codebook.php -run <system path to X-Payments>).

my script is in a folder named xp, I tried the following commands but to no avail.

cd public_html

and then

php regen-codebook.php -run xp

Any idea where I am going wrong?

Thanks

photo · #4 06-18-2012, 06:31 AM

I also tried,

Code:

php '''regen-codebook.php''' -run <'''public_html/xp'''>

and got the following error.

Quote:

syntax error near unexpected token 'newline'

What the samhill does that mean?

photo · #5 06-21-2012, 06:07 AM

For anyone who may need help with running the regen-codebook.php file from the command line, the following is what worked for me.

1. The server uses Cpanel
2. The xpayments folder is located at /home/mysite/public_html/xpayments
3. First you need to be in the folder /home/mysite/public_html/xpayments to run the script, to do this use the following command,

Code:

cd public_html/xpayments

4. Now to make sure you are in the proper folder use the following command,

Code:

pwd

This will show you exactly what folder you are in, if you are now indeed in /home/mysite/public_html/xpayments then use the following command,

Code:

php regen-codebook.php -run /home/mysite/public_html/xpayments

5. If all went well, the script should of run and you will receive 3 emails with your new pins and activate account and setup passwords link.

notes:
a) Use at your own risk, if your not confident using shell it would be best to open a ticket with QT to do this for you.
b) Make sure to edit mysite above with the name of your cpanel site name.

gblair · #6 06-23-2012, 06:08 AM

My issue with the regen-codebook turned out to be my webhost version of SAPI was set to CGI rather than the required CLI

If you get "SAPI is not CLI" - check with your host.
Mine did have both versions installed, but I had to specifically call the CLI version.

snowman99 · #7 07-10-2012, 08:31 PM

Is this for real? I installed Xpayments and I can login just fine. The codes work. Do I need to perform a code regen? Why? And has this been vetted by QT? Something smells fishy here. I've never seen such clumsy documentation of an important application. If this was for real, you would think it would have been added to the README file in the install.