CHANGELOG:

Version 1.2

• Uses AlertPay's new multiple-item checkout feature.
• Installation process simplified/automated (no coding/programming knowledge required)
• Includes shipping, tax and discount amounts as specified in your Virtuemart setup.
• Uses alertpay's parameter fields to specify item name, code, amount, description and quantity. Displays these as separate lines on the Alertpay checkout page along with subtotals, charges, and each total item price (see our screenshot below).
• Virtuemart Order Reference is included as a prefix to the first item in the checkout list.

Version 1.1

• Moved customizable parameters to fields.
• Available for global download on the www.joellipman.com website.

Version 1.0

• My first payment module for Virtuemart :c) !!!
• Hard-coded working version of AlertPay Payment Module.
• Order Reference is the item name and Order Description is text informing the customer that they've been emailed the details of the order.

IMPORTANT NOTE:

If you have any other AlertPay payment module(s) already installed on your Virtuemart setup, then make a copy, as a backup, of the following files:

/administrator 
     /components 
          /com_virtuemart 
               /classes 
                    /payment
                         /ps_alertpay.php
                         /ps_alertpay.cfg.php

INSTALLATION:

1. Download the alertpay_payment_module.zip from www.joellipman.com/features/downloads.html > downloads > Joomla 1.5 > AlertPay Payment Module (requires registration)
2. Unzip the two files (ps_alertpay.php and ps_alertpay.cfg.php) to a temporary drive on your local computer
3. Check that you don't already have someone else's alertpay payment module by looking in the folder as per my "Important Note" section above.
4. Upload the two PHP files to the directory (/administrator/components/com_virtuemart/classes/payment)
5. Login to your administration panel (back-end)
6. Go to Components > Virtuemart > Store > List Payment Methods > New
7. Ensure the "Active" checkbox is enabled (ticked)
8. "Payment Method Name" should be AlertPay (doesn't have to be but it's easier to remember)
9. "Code" is AP (again just easier to remember)
10. Next to "Payment class name", select ps_alertpay from the drop-down.
11. For "Payment method type", put a dot next to the HTML-form based (e.g. Paypal) option.
12. Click on the "SAVE" icon (top-right).
13. You should be returned to the "Payment Method List" page, click on the AlertPay entry you just made.
14. Click on the Configuration tab (next to Payment Method Form tab)
15. There should be a message saying that ps_alertpay.cfg.php is Writeable. If it isn't then check the permissions on the file using your FTP client.
16. Complete the fields just under this message as appropriate.
    • Purchase Type should be item-goods
    • Business email name should be the email address YOU registered with Alertpay as.
    • Return URL is the page that the user should be directed to when they click on "Return to Merchant"
    • Cancel URL is the page if the user starts signup to AlertPay but then cancels for whatever reason.
17. If you are using a javascript-enabled browser, the Payment Extra Info field should auto-complete itself with a load of programming code.
18. Click on the "SAVE" icon again (top-right).
19. Test as appropriate (Login to your AlertPay Account and Enable TEST mode)

FUTURE CONSIDERATIONS:

• Additional Charges field for AlertPay is not accounted for and set statically to 0.00
• Make price on each row not do for each but in total (or tell alertpay to indicate that price is for each item "@")
• Pass through AlertPay username and password for wholesalers which avoids the AlertPay pages and processes it without leaving the site.

TO RE-INSTALL/UPGRADE:

1. Upload just the ps_alertpay.php from the downloaded zip to the specified folder ("payment").
2. Go into your admin panel and clear the "Payment Extra Info" textbox (so that it's blank)
3. Click the SAVE icon
4. Go back to into the AlertPay entry and click the "Configuration" tab
5. The "Payment Extra Info" field should autocomplete itself (if it doesn't then enable javascript)

ADDITIONAL:

Now that I've learnt to write Virtuemart Payment Modules, if there's an e-merchant system that you would like to use that no one else has, I'll be happy to look at a solution. Contact me or Leave a comment below. Also if you have any questions about this payment module, again do not hesitate to contact me.

SCREENSHOT:

==Download==
==Version 1.2==