https://github.com/ousret/pyteliummanager

Python library to manipulate Ingenico mobile payment device like iCT220 or iWL220 equipped with Telium Manager. RS232/USB.
https://github.com/ousret/pyteliummanager

amex cetelem credit-card debit-card eftsmart2 eftsmart4s ingenico ingenico-ict220 payment point-of-sale pos telium-manager

Last synced: 12 days ago
JSON representation

Python library to manipulate Ingenico mobile payment device like iCT220 or iWL220 equipped with Telium Manager. RS232/USB.

• Host: GitHub
• URL: https://github.com/ousret/pyteliummanager
• Owner: Ousret
• License: mit
• Created: 2016-10-20T12:21:29.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2021-09-18T19:38:32.000Z (over 3 years ago)
• Last Synced: 2024-12-18T00:08:49.127Z (13 days ago)
• Topics: amex, cetelem, credit-card, debit-card, eftsmart2, eftsmart4s, ingenico, ingenico-ict220, payment, point-of-sale, pos, telium-manager
• Language: Python
• Homepage: http://pyteliummanager.readthedocs.io
• Size: 103 KB
• Stars: 105
• Watchers: 19
• Forks: 20
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
Welcome to Ingenico for Human 👋 





  One of the few library that help you use this kind of hardware


  

    

  

  

  

    

  

  

    

  

  

    

  

  

      

  

  

    

  

  

  


  



> Python library to manipulate Ingenico mobile payment device equipped with Telium Manager. RS232/USB.

> Please note that every payment device with Telium Manager should, in theory, work with this.

##### PyPi

*Python 2.7 support has been added to master branch since v2.3.0*

```sh

pip install pyTeliumManager --upgrade

```

##### How to start using pyTeliumManager

```python

# Import telium package

from telium import *

# Open device

my_device = Telium('/dev/ttyACM0')

# Construct our payment infos

my_payment = TeliumAsk.new_payment(

    12.5, 

    payment_mode='debit',  # other mode: credit or refund.

    target_currency='EUR',

    wait_for_transaction_to_end=True,  # If you need valid transaction status

    collect_payment_source_info=True,  # If you need to identify payment source

    force_bank_verification=False

)

# Send payment infos to device

try:

    if not my_device.ask(my_payment):

        print('Your device just refused your transaction. Try again.')

        exit(1)

except TerminalInitializationFailedException as e:

    print(format(e))

    exit(2)

# Wait for terminal to answer

my_answer = my_device.verify(my_payment)

if my_answer is not None:

    # Convert answered data to dict.

    print(my_answer.__dict__)

    

    # > {

    # '_pos_number': '01', 

    # '_payment_mode': '1', 

    # '_currency_numeric': '978', 

    # '_amount': 12.5, 

    # '_private': '0000000000', 

    # 'has_succeeded': True, 

    # 'transaction_id': '0000000000', 

    # '_transaction_result': 0, 

    # '_repport': '4711690463168807000000000000000000000000000000000000000', 

    # '_card_type': 

    #  {

    #      '_name': 'VISA', 

    #      '_regex': '^4[0-9]{12}(?:[0-9]{3})?$', 

    #      '_numbers': '4711690463168807', 

    #      '_masked_numbers': 'XXXXXXXXXXXX8807'

    #  }

    # }

if my_answer.has_succeeded:

    print("Your payment has been processed using a {0} card. Id: {1}".format(my_answer.card_type.name, my_answer.card_type.numbers))

else:

    print("Your payment was rejected. Try again if you wish to.")

```

##### **How to enable computer liaison with Ingenico device**

1. Press "F" button

2. Press 0 - Telium Manager

3. Press 5 - Init

4. Press 1 - Param

5. Select  - Checkout

6. Select "Enable"

7. Choose your preferred interface (USB, COM1, COM2)

**Tested devices:**

- Ingenico iWL250

- Ingenico iCT220

- Ingenico iCT250

Should work with all i**2XX device equipped with Telium Manager app.

Feel free to repport issue if your device isn't compatible with this package.

**Won't work**

- All direct PinPad liaison, also known as iPP3XX. (see issue #2)

#### Q-A

> Will this package cause loss of money in any way ?

- You shouldn't worry about that, I've deployed it for a different store in 2015. No loss has been reported yet.

- If you hesitate on how to use this package, feel free to ask me before using it.

> My device isn't working with this package.

- Make sure you've followed **How to enable computer liaison with Ingenico device** steps above beforehand.

- If you're on Windows, make sure you've installed the correct driver.

- Try every COM port, one by one.

- On Linux it should be located at */dev/ttyACM0*, if not run ```ls -l /dev/tty* | grep ACM``` to locate it.

#### Contributions

Feel free to propose pull requests. This project may be improved in many ways.