Payment System Instructions

INSTALLATION INSTRUCTIONS & USER GUIDE:

Be sure to ALWAYS backup your database and store files before installing ANY extension.

1) Go to Extension>Installer. Upload the .ocmod zip file then press the refresh button on the Modifications page.

EXTENSION SETTINGS & SETUP:

  1. Go to Extension/Modules Find the Extensions name and click install.
  1. After installation click edit to adjust extension settings.
  1. After making extension settings be sure to go to Extensions/Modifications and click refresh.
  1. If you are using any type caching software or increase speed software. Be sure to refresh the cache after extension installation.
  2. Go to admin, click on Extensions/Modules/Payment System, click install then edit and set all of the Payment System general parameters and payment terms then click save.

  1. Payment System Pro has 2 product settings. 

a) Set all products to use payment system. This will flag all products to be allowed to checkout using payment system.

b) If the above setting is not made, then you have to edit each product in the data tab to Buy using Payment System. This allows you to set per product as opposed to all products. If all products is set in general settings it will override the individual setting.

  1. Go to Extensions/Order Totals/ and set the payment system order totals. The sort order is crucially important otherwise cart calculations will be incorrect.

There are 3 that must be set. See example below:

  • Payment System Admin Fee     
  • Payment System Deposit     
  • Payment System Payment

When using Payment System Pro customers CANNOT use the guest checkout feature in OpenCart. Your customers will not be able to checkout using guest checkout when a payment system product is in the cart, even if it is enabled. Guest checkout does not grab enough information for payment system pro to work properly. You can leave it enabled if you'd prefer so your customers can checkout on regular non payment system sales.

SPECIAL PAYPAL STANDARD NOTE:

If you are going to accept multiple payments for the same order, you need turn the highlighted section off. This is a PayPal setting (see attached screenshot)


It is under Profile -> My Selling Tools

ADDITIONAL NOTES:

Although we have taken every step to foresee any problems or errors that may happen, this is in no way a Guarantee that this Extension will work with a highly modified OpenCart store or installation. We can certainly help you with basic information but there may be a situation where USING THIS EXTENSION COULD COST YOU MORE MONEY.

EMAIL NOTIFICATIONS:

Standard Method

The email notifications work when a customer goes to the storefront or the admin user goes to the admin. It is a function in the footer that triggers the notifications to be sent out. So this means that if no one visits the admin or store front the email notifications will not go out until someone visits either one.

Using Cron Jobs Method

When using the cron job method for email notifications the user must have common knowledge on how to setup a cron job using cPanel or WHM.

cPanel or WHM Overview

Cron jobs are scheduled tasks that the system runs at predefined times or intervals. Typically, a cron job contains a series of simple tasks that the system runs from a script file. 

Note:

Exercise caution when you schedule cron jobs. If you schedule them to run too often, they may degrade your server's performance.

Add a cron email

The Cron Email section of the interface allows you to enter an email address for the system to send notifications when your cron jobs run. To set an email address, perform the following steps:

  • In the Email text box, enter the email address at which you wish to receive the notifications.
  • Click Update Email.

Add a cron job

  • To create a cron job, perform the following steps:

  • Select the interval at which you wish to run the cron job from the appropriate menus, or enter the values in the text boxes.
    • Common Settings — This menu allows you to select a commonly-used interval. The system will configure the appropriate settings in the MinuteHourDayMonth, and Weekday text boxes for you.

      Note:

      If the wildcard characters (*) and intervals confuse you, this menu is an excellent way to learn how to configure the other fields.

    • Minute — Use this menu to select the number of minutes between each time the cron job runs, or the minute of each hour on which you wish to run the cron job.
    • Hour — Use this menu to select the number of hours between each time the cron job runs, or the hour of each day on which you wish to run the cron job.
    • Day — Use this menu to select the number of days between each time the cron job runs, or the day of the month on which you wish to run the cron job.
    • Month — Use this menu to select the number of months between each time the cron job runs, or the month of the year in which you wish to run the cron job.
    • Weekday — Use this menu to select the days of the week on which you wish to run the cron job.

  • In the Command text box, enter the command that you wish the system to run.

    Example:

    In Admin/Extensions/Modules/Payment System be sure your have set the secret code.

    As an example we can now set a cronjob by setting the secret code to 12345678 (do not use 12345678 just an example). 

    wget –qO http://www.YOURWEBSITE.com/?secret_code=12345678

    Using cpanel we can now get the command to execute everything at 8:30am using the above command.

    Or if your using crontab, you can add the line

    30 8 * * * wget –qO http://www.YOURWEBSITE.com/?secret_code=12345678

    Important:

    • You must specify settings for the MinuteHourDayMonthWeekday, and Command text boxes.
      • The interface displays a green check mark icon () next to each setting that you properly set.
      • If you enter or select an invalid setting, the interface displays a red warning icon () next to that setting.
    • Exercise extreme caution when you use the rm command in a cron job. If you do not declare the correct options, you may delete your home directory's data.
  • Click Add New Cron Job.

USER GUIDE:

The Payment System Pro extension is a comprehensive payment system extension for OpenCart. When customers checkout if selected they will have the ability to select a payment plan for the sale.

If you have any questions about the installation process or how to use the extension please contact us.