DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Yellowpay Gateway for commerce

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Cedric Spindler
Changed:2008-12-16T12:10:57
Classification:yellowpay2commerce
Description:The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----
Keywords:forAdmins
Author:Cedric Spindler
Email:cs@cabag.ch
Info 4:
Language:en

img-1 img-2 EXT: Yellowpay Gateway for commerce - yellowpay2commerce

EXT: Yellowpay Gateway for commerce

Extension Key: yellowpay2commerce

Language: en

Keywords: forAdmins

Copyright 2000-2008, Cedric Spindler, <cs@cabag.ch>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

This extension is sponsored by cab services ag: http://www.cabag.ch/typo3.html

Table of Contents

EXT: Yellowpay Gateway for commerce 1

`Introduction 3 <#1.1.Introduction|outline>`_

What does it do? 3

Screenshots 3

`Users manual 4 <#1.2.Users%20manual|outline>`_

FAQ 4

`Administration 5 <#1.3.Administration|outline>`_

FAQ 5

`Configuration 6 <#1.4.Configuration|outline>`_

`Tutorial 7 <#1.5.Tutorial|outline>`_

`Known problems 8 <#1.6.Known%20problems|outline>`_

`To-Do list 9 <#1.7.To-Do%20list|outline>`_

`ChangeLog 10 <#1.8.ChangeLog|outline>`_

Introduction

What does it do?

This extension provides a commerce payment-provider to the yellowpay payment gateway. The yellowpay-provider will be added to the existing list of payment providers in commerce.

Please put any bug reports or feature requests on forge.typo3.org project page. Patches are welcome when tested and commented properly (always with documentation text please).

Important

This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments!

Screenshots

((generated))
Selection of the Yellowpay payment method
img-3 Extension Manager Configuration.

The Postfinance backoffice will provide you with the required information:

img-4

Users manual

  • After installing the extension a new payment article is added to the commerce payment product. You probably want to rename it, translate it or define a price.
  • Please be careful with this aricle, because the field “classname” is not shown in the backend, but the value in this field is required for the extension to work.

FAQ

((generated))
Does the extension check if the commerce order and userdata is valid?

No. This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments!

Administration

  • You need a yellopay-payment-article. The classname of this article has to be set to “yellowpay” in the table “tx_commerce_articles”.
  • After installing the extension you sould configure it using the Extension Manager

FAQ

Questions? Feel free to ask.

Configuration

  • You can provide a test payment URL (yellowpayTestPaymentURL). As soon as you enter the URL for the production environment (yellowpayPaymentURL), the extension will use it instead of yellowpayTestPaymentURL.
  • The locale for selecting the Yellowpay gateway language is taken from $GLOBALS['TSFE']->config['config']['locale_all']. Be sure to set it. Example (TS Constants): lang.current_locale = de_DE.UTF-8
  • The Postfinance backoffice has to be configured as shown in the Tutorial.

Tutorial

  • Make a contract with Postfinance

  • Provide the Postfinance backoffice with the required information like URLs and Payment method.

    • 1.1.: GET

    • 1.2.: Your email adresses for the shop

    • 2.2.: URL that leads to the site containing the checkout plugin.

    • 4.1. first field: URL thad leads to the site containing the checkout plugin, followed by ?tx_commerce_pi3[terms]=termschecked&tx_commer ce_pi3[step]=finish&tx_commerce_pi3[yellowpay]=success

    • 4.1. second field: URL thad leads to the site containing the checkout plugin, followed by:

      ?tx_commerce_pi3[terms]=termschecked&tx_commerce_pi3[step]=finish &tx_commerce_pi3[yellowpay]=failed

    • 4.2.: “Make this request just after the payment and let the result customize the answer seen by customer (HTML code or redirection).”

      Authorize to defer the request if the online request has failed ? No.

    • 4.3.: “for "3 tiers" modes only”

    • 5.2.: “Display a ticket to the client if a redirection to your website is detected just after the post-payment process (redirection in the POST-SALE or ACCEPTURL page)”

    • 5.4.: “Send an email to the client if the address is available “

    • 6.: Yes

    • 7.1.: Never

    • 8.: Online (Immediate)

    • 9.: Automatic authorisation and payment (data capture) on request

  • Install the extension yellowpay2commerce from TER.

  • Set the values for the fields yellowpayTestPaymentURL, yellowpayPSPID, yellowpayOrderIDprefix and yellowpayOrderTitle. URL and PSPID are provided by the Postfinance backoffice. Examplex provided by the Extension Manager Configuration.

  • Set a name, price and translations for the yellowpay payment article in the commerce module.

  • Test your payment system.

  • If everything works and you are ready for production, put the production URL into the Extension Manager Configuration field “yellowpayPaymentURL”.

Known problems

This extension does not check if the payment was successful or if the order and userdata is valid! Manual checking in the Postfinance Backoffice by the seller is strongly recommended. TYPO3 does not provide the required security level to handle fully trusded payments!

To-Do list

The Postfinance backoffice provides the possibility to configure a lot of things like the layout of the gateway, predefined user and payment settings. Implement some of them in this extension.

ChangeLog

15.12.2008 - Cedric Spindler <cs@cabag.ch>

* Version 0.0.2

* the extension now uses currency / language settings from TypoScript settings.

* added extension icon

28.11.2008 - Cedric Spindler <cs@cabag.ch>

* Version 0.0.1

* implemented request handling with the yellowpay payment gateway

* added ext_conft_template.txt for configuration

30.10.2008 - Cedric Spindler <cs@cabag.ch>

* Initial release - Version 0.0.0

* Defined the steps for the orderprocess

* TODO: develop the request handling for communication with yellowpay

10