.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


===========================
EXT: Payment Transactor API
===========================

:Author:
      Christopher

:Created:
      2010-12-18T19:57:23

:Changed by:
      Holzinger Franz

:Changed:
      2014-12-06T14:29:13.159897685

:Classification:
      transactor

:Keywords:
      forDevelopers, forBeginners

:Author:
      Franz Holzinger

:Email:
      franz@ttproducts.de

:Language:
      en


.. _img-1-img-2-EXT-Payment-Transactor-API:

|img-1| |img-2| EXT: Payment Transactor API
===========================================

Extension Key: transactor

Language: en

Version: 0.3.0

Keywords: forDevelopers, forBeginners

Copyright 2013-2014, Franz Holzinger, <franz@ttproducts.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.org

.. _Table-of-Contents:

Table of Contents
-----------------

**`EXT: Payment Transactor API 1 <#__RefHeading__5708_1738894311>`_**

**`Introduction 3 <#__RefHeading__5710_1738894311>`_**

`What does it do? 3 <#__RefHeading__463_413120346>`_

`Screenshots 3 <#__RefHeading__465_413120346>`_

**`Users manual 4 <#__RefHeading__467_413120346>`_**

`FAQ 4 <#__RefHeading__31509_818911409>`_

**`Configuration 5 <#__RefHeading__31515_818911409>`_**

**`ChangeLog 6 <#__RefHeading__31623_818911409>`_**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This extension provides a basic API on which developers can write
their own payment extensions. It covers a calling of the gateway and a
final check if the payment is successful. This can be done in
different ways. The transactor API is intended to cover all possible
ways. Then only the specific differences need to be implemented in the
gateway specific extensions which shall have the extension keys in the
format 'transactor\_ *myextensionkey* '. Insert your extension key
after the underline character ('\_').

This extension's EM configuration will be available in all specific
extensions.

TYPO3 extensions will simply call the transactor API's php code. The
setup of these extensions will determine which specific gateway
extension will finally be called.

Currently tt\_products supports the transactor API.


.. _Screenshots:

Screenshots
^^^^^^^^^^^

This extension is only a programmer's API. It provides only a partly
output which is returned to the calling extension.


.. _Users-manual:

Users manual
------------

The user installs tha transactor API extension. Then he must open the
EM configuration and confirm the default settings.


.. _FAQ:

FAQ
^^^

- Why is there a second payment extension? I have formerly used the
  Payment Library.The code of the Payment Library until version 0.3.0
  contained a lot of bugs, and the development of it seemed to have
  completely stopped. Therefore I decided to start with a fork and make
  all necessary bug fixes there. The first version of the Payment
  Transactor API is a rewrite of the Payment Library. Many code lines
  have been removed. A lot of code lines have been taken from the
  paymentlib\_paypal extension, in order to make the amount of code for
  the extension transactor\_paypal much smaller and the job for the
  extension programmers easier. And other improvements in the setup and
  initialization have been made.

- Where can I get help for my user or developer questions?Use the forum
  at `http://jambage.com <http://jambage.com/>`_ to ask questions under
  “Payment Transactor API” or report errors. You need to create your
  account at `http://www.jambage.com/kontakt/forum/konto.html
  <http://www.jambage.com/kontakt/forum/konto.html>`_ .


.. _Configuration:

Configuration
-------------

You can configure this extension in the Extension Manager.

At the moment it contains the names of fields which are in the basket
and shall be transmitted to PayPal. This is due to future change.
Almost everything shall be made configurable.

Copy the file 'template/transactor.tmpl' of the transactor extension
into your fileadmin folder. The set the setup accordingly (see your
application extension's manual).


.. _ChangeLog:

ChangeLog
---------

.. ### BEGIN~OF~TABLE ###


.. _0-3-0:

0.3.0
^^^^^

.. container:: table-row

   Version
         0.3.0
   
   Changes
         support for TYPO3 6.2



.. _0-2-2:

0.2.2
^^^^^

.. container:: table-row

   Version
         0.2.2
   
   Changes
         add this manual


.. ###### END~OF~TABLE ######


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 44
.. :id: graphics5
.. :name: graphics5
.. :vspace: 57
.. :width: 161

.. |img-2| image:: img-2.png
.. :align: left