Python interface to (French) bank online credit card processing services
Go to file
Benjamin Dauvergne c4f59e4412 tests: make payfip tests compatible with zeep 4.0 2020-10-15 21:31:41 +02:00
debian debian/control: add git to build-dependencies 2020-05-14 07:29:59 +02:00
eopayment systempayv2: map DENIED and CANCELLED result codes (#17065) 2020-10-15 21:05:36 +02:00
tests tests: make payfip tests compatible with zeep 4.0 2020-10-15 21:31:41 +02:00
.coveragerc add .coveragerc 2016-02-01 18:41:31 +01:00
.gitignore update gitignore (#38405) 2020-01-13 10:52:10 +01:00
COPYING misc: include copy of GNU GPL 3 in package 2018-08-12 19:53:29 +02:00
Jenkinsfile Jenkinsfile: target default suite (#41301) 2020-05-14 07:34:24 +02:00
MANIFEST.in start support for PayFiP Regie web-service (#38405) 2020-01-07 10:50:12 +01:00
README.txt update README and docstrings (#47539) 2020-10-12 15:46:41 +02:00
setup.py setup.py: include package data (#39115) 2020-01-20 15:49:42 +01:00
tox.ini tox: limit mock version for compatibility with python 3.5 2020-10-06 09:26:43 +02:00

README.txt

Interface with French's bank online credit card processing services
===================================================================

Services supported are:
- ATOS/SIPS v2 used by:
  - BNP under the name Mercanet,
  - Banque Populaire (before 2010/2011) under the name Cyberplus,
  - CCF under the name Elysnet,
  - HSBC under the name Elysnet,
  - Crédit Agricole under the name e-Transactions,
  - La Banque Postale under the name ScelliusNet,
  - LCL under the name Sherlocks,
  - Société Générale under the name Sogenactif
  - and Crédit du Nord under the name Webaffaires,
- Payzen/SystemPay v2 by Banque Populaire (since 2010/2011) and Caisse d'Épargne (Natixis)
- TIPI/PayFiP Régie
- PayFiP Régie Web-service
- Ogone
- Paybox
- Payzen

You can emit payment request under a simple API which takes as input a
dictionnary as configuration and an amount to pay. You get back a
transaction_id. Another unique API allows to handle the notifications coming
from those services, reporting whether the transaction was successful and which
one it was. The full content (which is specific to the service) is also
reported for logging purpose.

The spplus and paybox module also depend upon the python Crypto library for DES
decoding of the merchant key and RSA signature validation on the responses.

Some backends allow to specify the order and transaction ids in different
fields, in order to allow to match them in payment system backoffice. They are:
- Payzen
- SIPS
- SystemPay
- PayFiP Régie Web-Service

For other backends, the order and transaction ids, separated by '!' are sent in
order id field, so they can be matched in backoffice.

PayFiP Régie Web-Service
========================

You can test your PayFiP regie web-service connection with an integrated CLI utility:

    $ python3 -m eopayment.payfip_ws info-client --help
    Usage: payfip_ws.py info-client [OPTIONS] NUMCLI

    Options:
      --help  Show this message and exit.

    $ python3 -m eopayment.payfip_ws get-idop --help
    Usage: payfip_ws.py get-idop [OPTIONS] NUMCLI

    Options:
      --saisie [T|X|W]         [required]
      --exer TEXT              [required]
      --montant INTEGER        [required]
      --refdet TEXT            [required]
      --mel TEXT               [required]
      --url-notification TEXT  [required]
      --url-redirect TEXT      [required]
      --objet TEXT
      --help                   Show this message and exit.

    $ python3 -m eopayment.payfip_ws info-paiement --help
    Usage: payfip_ws.py info-paiement [OPTIONS] IDOP

    Options:
      --help  Show this message and exit.