Direct deposit prepay payment method addon for WP e-Commerce Wordpress plugin

AmcWpecDdpp - AivoMatic.Com WP e-Commerce Direct deposit prepay

AmcWpecDdpp is a free and open source direct deposit prepay payment method addon for WP e-Commerce plugin of Wordpress CMS/blog publishing application. WP e-Commerce is also know as Wordpress Shopping Cart.

AmcWpecDdpp is particularly suitable to Finland because it implements bank reference number standard of The Federation of Finnish Financial Services. But AmcWpecDdpp is suitable to many other countries too. It supports multiple translations (Finnish and English are included) and is easily customized using simple template files. AmcWpecDdpp doesn't require any modifications to core files of Wordpress or WP e-Commerce.

Professional support available from Aivomatic Ltd in Finnish and English.

Additional system requirements compared to Wordpress and WP e-Commerce:

  • PHP5

Developed and tested using Wordpress 2.9.2 and WP e-Commerce 3.7.6.5. The following screenshots show default themes and templates.

Please note that AmcWpecDdpp does not work together with WP e-Commerce 3.8 on later.

Customer view

Payment method selection

AmcWpecDdpp in listed as one of the payment methods at the checkout.

Checkout

Direct deposit information

The following direct deposit and banking information is displayed to customers who choose direct deposit prepay as their payment method.

Edit template file info-page.xx.html to change this page.

Direct deposit information

Direct deposit information email

Direct deposit and banking information is also sent to customer by email.

Edit template file info-email.xx.txt to change email contents.

Direct deposit information email

Transaction results

Finally at the end of checkout process the standard WP e-Commerce transaction results page is shown to customer and at the same time a purchase receipt is sent by email.

Transaction results
Purchase receipt email

Merchant view

Sales

Sales list at WP e-Commerce Store panel.

Sales list at admin panel

Sales details

Bank reference number, number of due days and the due date are shown in sales details.

Sales details

Installation

Dowload

You can download AmcWpecDdpp from here.

AmcWpecDdpp is rather easy to install. It doesn't require any modifications to core files of Wordpress or WP e-Commerce. But as always, you should backup your files and database before your start the installation.

ZIP-archive contents

Extract the contents of AmcWpecDdpp-n.n.n.zip (where n.n.n is the version number) to a temporary folder on your local computer. If you have troubles opening the ZIP-file, try an other ZIP-utility.

Copy the ZIP contents (i.e. amcwpecddpp.php file, aivomatic directory and its subdirectories and files) to your web server to .../wp-content/plugins/wp-e-commerce/merchants/. The .../aivomatic/amcwpecddpp/doc -directory, which contains the developer documentation, doesn't need to be copied to the server.

Note. The automatic plugin update function removes payment addon files. You will have to copy the files again if you use the automatic update function to update WP e-Commerce.

ZIP archive contents

Language specific files

There are four language specific files, where "xx" is the locale code:

  • Language files: amcwpecddpp-xx.po and amcwpecddpp-xx.mo
  • Email template: info-email.xx.txt
  • HTML template: info-page.xx.html

AmcWpecDdpp includes readily translated files for Finnish (fi) and U.S. English (en_US). New translations can be created easily.

Names of the language specific files must match your language setting. See WPLANG constant at line 67 on wp-config.php file in Wordpress root directory. Read more at http://codex.wordpress.org/Translating_WordPress

So if your locale is "en_US" (or you haven't set it, when it defaults to "en_US"), you may use the already existing email template file "info-email.en_US.txt". But if your locale is "en", then you must rename the email template file to "info-email.en.txt" and do the same for all other language specific files.

Create new purchase status

You may want to create a new purchase status, e.g. "Prepay pending", to database table wp_wpsc_purchase_statuses. Use an application like phpMyAdmin or run the SQL query on purchase-status.sql file. The table prefix "wp_" may be different on your system. See line 57 on wp-config.php in Wordpress root directory.

Purchase statuses

Configuration

Log into Wordpress admin panel. Open WP e-Commerce settings panel (Store/Settings/Payment settings). Select "Direct deposit prepay" in General Settings and activate it by clicking the Update button

General settings

Select "Direct deposit prepay" from Payment Gateway dropdown list. Set the configuration values and click Update.

Store/Settings/Admin/"Purchase Receipt - Reply Address" and "Purchase Receipt - Reply Name" should also be set.

Payment Gateway configuration

Template files

There are two template files per language. Email body template (info-email.xx.txt) and info page template (info-page.xx.html). Edit the template files to suit your needs.

There is a number of template variables available for email subject, email body and info page. Here is a list of variable place holders which you may use in the templates:

  • %receiver_name%
  • %bank_account%
  • %bank_name%
  • %iban%
  • %bic%
  • %due_days%
  • %due_date%
  • %order_num%
  • %bank_ref%
  • %total_price%
  • %currency%
  • %first_name%
  • %last_name%
  • %email%
  • %transact_url%
  • %module_path%