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: paypal2commerce

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed:2009-04-05T20:31:55
Author:Martin Holtz
Email:paypal2commerce@martinholtz.de
Info 3:
Info 4:

EXT: paypal2commerce

Extension Key: tx_paypal2commerce

Copyright 2000-2002, Martin Holtz, <paypal2commerce@martinholtz.de>

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.com

Table of Contents

EXT: paypal2commerce 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 1

Adminstration 1

FAQ 2

Configuration 2

FAQ 2

Reference 2

Tutorial 3

Known problems 3

To-Do list 3

Changelog 3

Important guidelines 4

Issues with Open Office documentation for TYPO3 4

Inserting images 4

Paragraph styles 4

Linking 5

Meta data and updates 5

Introduction

What does it do?

This extension enables the payment-method with paypal. It use the paypal-express-checkout feature (implemented using the Name-Value Pair API)

enable CURL – the server interacts with Paypal via CURL.

Your customer will be send in the last checkout-step to the paypal- site, where he logs in and send you the money.

After that, he will be redirected to your site.

This extension was sponsored by http://www.kennziffer.com via bugs.typo3.org (http://bugs.typo3.org/view.php?id=5311) – thanks!

Many enhancements were made by Marcus Krause.

Initially developed by Martin Holtz http://www.martinholtz.de/

Screenshots

img-1 Editing database field “classname” in table “tx_commerce_articles”:

img-2 Configuration of the extension. You have to put your paypal- account information in. You should test paypal via the paypal sandbox. ( https://developer.paypal.com )

You are able to select, which currency your shop should support.

The “ Payment error PID ” defines the page-id where you customer should be redirected to, if there was an error.

Users manual

Users should not change the paypal-article, because of the hidden “classname” field.

Adminstration

You need an paypal-Payment-Article with an price (maybe 0 Euro). Then you have to set the database-field “classname” to “paypal” in the table “tx_commerce_articles”.

If you install the extension you are should change some settings like your paypal-account.

You should test your SHOP via https://developer.paypal.com first!

Your API-Key in the sandbox is different from the API-Key in your live-system

FAQ

  • Error Message: MAIN:FATAL! No payment possible because I don't know how to handle it! (class not set!:, file not found!:)Create an article "Paypal", set a price for it (may be set it to 0). Now you have to edit the field "classname" of the "Paypal"-Article in "tx_commerce_articles" and set it to "paypal".
  • Empty Browserwindow/white page:You should check your curl-settings – there is an php-script “test_curl.php” in the extension-directory. Please check, it that works – if not, you have to check your curl configuration.
  • Some other questions? Feel free to ask:)

Configuration

If config.baseURL is not set, t3lib_div::getIndpEnv('TYPO3_SITE_URL') will be used.

Maybe there could some curl-options configurated in future, if somebody needs, tell me.

You have to enable CURL in Install-Tool too: [SYS][curlUse] = 1

Tutorial

To be done.

Known problems

  • There is no address validation between paypal and commerce yet.
  • If the payment-amount of paypal is different to the actuall amount of the basket (btw. Via “hacking”), the checkout is stopped but the payment is not rejected at all.

To-Do list

  • Writing an short tutorial
  • maybe: changing status of order?
  • Adding an percentage fee for paying with paypal
  • the paypal-login page could be customized
  • an address from paypal could be taken, instead of adding the address in commerce

Collobarate

If you want to enhance this extension, or you have small or larger pieces for this documentation, feel free and join the project “paypal2commerce” on forge: http://forge.typo3.org/projects/show /extension-paypal2commerce

Or you can fill up an issue on forge – but all development for this extension happens in my spare time – so perhaps you could join the project and do it yourself.

Changelog

09-04-05 Martin Holtz

  • Integrated Changes from Marcus Krause
    • Error-handling was added
    • requires PHP5
    • code-refactoring
    • added currencies
  • delivery address from commerce is now shown in paypal

07-12-23 Martin Holtz

* Writing the manual

* if config.baseUrl is not set, t3lib_div::getIndpEnv('TYPO3_SITE_URL') is be used

* some documentation inside the code

07-12-12 Martin Holtz

* Quick Security-Bug-Fix: the amount of the basket has to be the same, which is payed via paypal,

otherwise the checkout is canceld (the payment not!)

07-06-05 Martin Holtz

* Wie should use &useraction=commit

07-06-04 Martin Holtz <typo3@martinholtz.de>

* Get the URL via config.baseURL

* deleted some debug-Code

* corrected error in ext_localconf.php

07-05-29 Martin Holtz <typo3@martinholtz.de>

* Initial release

img-3 EXT: paypal2commerce - 4