README.txt

ZPaybox is a small but effective product dedicated to simplify usage of the Paybox payment system from Zope.

It is written by Olivier DECKMYN, Ingeniweb ([email protected])

Introduction

ZPaybox is a simple product that handle making call to the Paybox payment system.

What is Paybox ?

Paybox is a secure internet payment system. It's the same service as the one offered by your bank. But it's cheaper, AND it works with your EXISTING bank account.

More here : http://www.paybox.com

We have no link with paybox. We do not earn money saying their solution is good. This is done for free.

What is ZPaybox

See introduction :)

How does ZPaybox work ?

Once the product is installed, you should have a new object type "Paybox".

PLEASE READ PAYBOX DOCUMENTATION CAREFULLY BEFORE GOING FURTHER

Properties

server : web server hosting the paybox.cgi file (should be on YOUR platform). ex : www.mydomain.com
cgi : path to cgi on given server. ex : /cgi-bin/paybox.cgi
site : Account number given to you by Paybox once you sign the contract with them. A test account number is 1999888
rang : As "site" property. A test number is : 99
url_cancelled : URL where the paybox system sends the user if the transaction is cancelled by the user
url_completed : URL where the paybox system sends the user if the transaction is correct
url_refused : URL where the paybox system sends the user if the transaction is refused by the system

Usage

For quick usage, just read 1, 2 and 3

Make a Paybox instance. Let's name it "paybox1"
Fill the properties for your need
Let's say you have a caddy system, and that you have on the latest page the following informations :
- customer email : email variable
- transaction amount : amount variable
- transaction reference (private to your system, for example the sequential number of transaction) : reference variable
To build the Paybox call button, just use:
```
      <dtml-var "paybox1(email=email, amount=amount, reference=reference)">
```
That's all :)
You might use the following other parameters, depending on your needs:
- lang : Language/Country of usage : "ca", "be", "fr", "en", or "de"
- currency : Default to EUR. See paybox for more options if any.
- sub_frequency : Subscription frequency (in monthes)
IF AND ONLY IF sub_frequency is specified and <>0 : the sub_ variables are considered and mean the following things : - sub_frequency : subscription frequency (in monthes)
- sub_ammount : subscription ammount (or 0 if the same as pdt_amount)
- sub_length : subscription length (or 0 if infinite) ie. nb of payings
- sub_day : subscription day (or 0 if the same as today)
- sub_delay : subscription delay (nb. of days to wait before starting subscription, or 0 to start now)
- button : label used on the generated button (optionnal, default is PAYBOX)