Thursday, May 17, 2012

Joomla! FREE AlertPay Payment Module for Virtuemart (JAV)

User Rating: / 3
PoorBest 

I believe I was the first to provide this for FREE but my entry has now been removed as there are many more commercial equivalents available now.

As I've been making other payment modules with IPN and VM order updates integrated, I will try to find time to do the same with this one but I need a guinea pig... any volunteers? You will need to have an alertpay account and shop, I just need to confirm that a test purchase will update the records in Virtuemart.

Tested On:

- Virtuemart v1.1.3 & Virtuemart v1.1.4
- Joomla v1.5.14 & Joomla v1.5.15
- PHP v5.2.8 & MySQL v5.1.30

==Download==
==Version 1.4==


Screenshots:

AlertPay Checkout Page Virtuemart Payment Method Payment Method List PHP Configuration Code

LICENSE:

These scripts are offered freely and in good faith. Please do not pass this off as your own work or try to sell it without due credit. Check back with us at joellipman.com for updates/fixes. If you want more support/work done to it, you could consider a donation :c)

BACKGROUND:

We've tried Googling the various AlertPay Payment Modules and trying to download them; to no avail though. Feed2post: Taken down and nothing there... CoderXO: where do i download it and why's it $35 dollars...? Well I ended up writing my own one and this one's free. As you can see I don't have an e-commerce site but I have friends who do and they're my guinea pigs...

This payment module will let you use Virtuemart with AlertPay. It takes your customer through the Virtuemart shopping process and then when they want to pay, they get redirected to the alertpay checkout/login page with a detailed order confirmation.

CHANGELOG:

Version 1.4
- Added GNU/GPL Copyright Information as requested by Joomla.Org Administrators.

Version 1.3
- Corrected bug of items price being affected by quantity.
- Removed leading zeros on order id as "ap_itemname" cannot be more than 50 characters.

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. Re-download the ZIP file from http://www.joellipman.com/features/downloads.html?func=fileinfo&id=9
  2. Decompress/unzip this to a temporary folder
  3. Upload ps_alertpay.php to /administrator /components /com_virtuemart /classes /payment
  4. Login to your admin panel of the site (back-end)
  5. Go Components > Virtuemart > Store > List Payment Methods > AlertPay
  6. Click on the "Configuration" tab
  7. Double-Check your business email username
  8. Clear any data in the "Payment Extra Info" field
  9. Click on the "Save" icon
  10. Click on "AlertPay" and return to the "Configuration" tab (should auto-populate)
  11. Click on the "Save" icon again.

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.

SCREENSHOTS:

AlertPay Checkout Page Virtuemart Payment Method Payment Method List PHP Configuration Code

VIDEO:

 

==Download==
==Version 1.4==

Add comment

Please note: all comments are reviewed before being published.


Security code
Refresh

Member Login

Joes Latest Members

A huge WELCOME goes to today's newest members:

  • infonat
Member Signups (Activated)
BeforeCurrentTrend
Day21ê
Week106=
Month11225ê
Year2,265613ê

Member Stats
1 member is currently online.
94 guests are currently online.
1,178 members are still deciding.
There are 5,936 members in total.

Latest Comments

Paypal Donations

Want to support my work? Any donation is a blessing :c)