EXT: Payment method "quickpay.dk"¶

What does it do?¶

This extension enables you to accept payment using the Quickpay payment gateway. It would typically be used with the tt_products web shop. Once installed, developers may also use Paymentlib directly to develop extensions that accept payment via Quickpay. There is rudimentary support for subscriptions (i.e. recurring payments).

There is already a similar public extension for Quickpay available. By implementing a newer version of the Quickpay protocol, this extension is more future proof.

Screenshots¶

Example of the Quickpay payment window (multiple languages are supported):

What is it used for?¶

• tt_products (simple web shop)
• Commerce (web shop)
• rlmp_eventdb (event calendar)

The above is an incomplete list of extensions that use Paymentlib, and may thus work with this extension.

About Quickpay¶

Quickpay is the safe choice for payment for Internet transactions. Quickpay works with all common credit- and debit cards. Quickpay is the payment solution that allows easy and safe integration all common credit-/debit cards with an arbitrary site on the Internet. Quickpay handles transactions for ~4500 merchants (October 09).

Get a Quickpay account at: http://www.quickpay.dk/

Installation¶

• Import and install the extension “paymentlib” via the Extension Manager.
• Install this extension, paymentlib_quickpay_dk, via the Extension Manager. NOTE: not to be confused with the extension paymentlib_quickpay. During installation, some of the extension configuration below is required.

Basic setup¶

For accepting payment with tt_products, the following extension configuration should be set in the Extension Manager during installation.

Advanced setup¶

In some cases, you may want to also configure the following extension configuration:

Administration¶

Once installed, this extension does not require administration. Be sure to read relevant documentation at quickpay.dk on how to manage transactions. You should login to Quickpay and learn how to use the payment manager. You would usually need to capture or reject transactions during delivery. Beware that transactions will automatically time out if they are not captured or rejected. You may wish to inform the shop administrator of the procedure for handling transactions, and the consequences of failing to handle them.

Development¶

Common use is to use an extension that has support for Paymentlib, but you can also use Paymentlib directly. While Paymentlib does not have a manual, it is documented in its README.txt file. Only the TX_PAYMENTLIB_GATEWAYMODE_FORM mode is supported.

If you develop an extension which needs to accepts subscriptions using Paymentlib, you can specify on a per transaction basis whether to perform a purchase (authorize) or subscription (subscribe) using the “transaction_setDetails” method. Example:

// set transaction to “authorize” or “subscribe”
$details['quickpay'] = array('msgtype' => 'authorize');
$paymentlib_provider->transaction_setDetails($details);

tt_products¶

plugin.tt_products {
   # your copy of the tt_products file template/products_template.tmpl
   templateFile = templates/products_template.tmpl

   payment {
      10 {
         title = Credit card
         handleLib = paymentlib
         handleLib {
            extName = paymentlib_quickpay_dk
            gatewaymode = form
            paymentMethod = paymentlib_quickpay_dk_cc_any
            currency = EUR
            templateFile = typo3conf/ext/tt_products/template/paymentlib.tmpl
         }
      }
   }
}

<!-- ###BASKET_PAYMENT_TEMPLATE### →
   ...bla...
   ###MESSAGE_PAYMENT_SCRIPT###
   ...bla...
<!-- ###BASKET_PAYMENT_TEMPLATE### end -->

Setting up a web shop¶

• Start by making sure you have the username and password to the Quickpay Payment Manager, you will need that to find further account information, to verify that transactions show up properly, and to switch from test to production mode.
• Login to the Payment Manager, and check that all necessary information is present. Make a note of the Merchant ID and the Shared Secret, so you still have it if the password is changed.
• Install and setup tt_products. Make sure to perform all necessary configuration and modification of templates, so you have a fully functioning web shop that only lacks payment.
• Install “paymentlib”. Optionally, create a sysfolder where transaction records are to be stored and enter its ID during the installation.
• Install “paymentlib_quickpay_dk”. During installation, enter appropriate information in the fields mentioned in the chapter about “Basic setup”.
• Configure tt_products payment, as described in the chapter about configuration of tt_products.
• Verify that payment works by buying something.
• Switch Quickpay from test-mode to production-mode, and perform another test purchase.