CELLULANT EXPRESS

qatingg

Python adapter for Cellulant Tingg express checkout version 2.1

To install: pip install qatingg

For all calls you first have to initiate the adapter with your credentials You can find your credentials over here: Developer portal

Params

adapter = MulaAdapter(<client id>, <client secret>, <service code>, <access_key>, <domain>, <url> , <path>)

domain: User have two options.These are cellulant's testing environments:

STAGING 
or 
SANDBOX
or
LOCAL

adapter.get_encryption(
        msisdn='0730xxxxxxx',
        customer_first_name='John',
        customer_last_name='Doeh',
        customer_email='john.doeh@jd.com',
        transaction_id='<unique>',
        account_number='066564ACC',
        amount=1000,
        currency_code='KES',
        country_code='KE',
        description='Air ticket',
        due_date='2019-10-01 12:12:00', or int(30) #Minutes
        payer_client_code='i8UytECD',
        language_code='en',
        success_url='http://callbackurl.com/success',
        fail_url='http://callbackurl.com/fail',
        callback_url='http://callbackurl.com/callback'
)

due_date: User can pass the number of minutes( int) for the session or use cellulant data format(''Y-m-d H:M:S'') To get the express page:

checkout_type: Cellulant have several ways of checkout

Example:
-------------
modal
express
themed-checkout
---------------

Note: Add payer client code, ONLY if you're testing single payment option' 

This will return checkout response as a url.

Example below:

Example url

Code Sample

import sys
from tingg.adapters import TinggAdapter
import random



def get_response():
    init = TinggAdapter(iv_key="h3tckgMNxxxxx",
                        secret_key="Nmxx6546xxxxxx",
                        access_key="$2a$08$wQ2ghgfhgfhfghfh64564",
                        service_code="EWWW5763434",
                        domain="SANDBOX",
                        url="http://localhost:3020",
                        path="/"
                        )

    response = init.get_encryption(msisdn='0724565xxxx',
                                customer_first_name='John',
                                customer_last_name='Doeh',
                                customer_email='john.doeh@jd.com',
                                transaction_id=random.randint(0, sys.maxunicode),
                                account_number='3434364ACC',
                                amount=1000,
                                currency_code='UGX',
                                country_code='UG',
                                description='Air ticket',
                                checkout_type="express",
                                due_date=30, # or "2019-12-12 12:12:12"
                                payer_client_code='',
                                language_code='en',
                                success_url='http://callbackurl.com/success',
                                fail_url='http://callbackurl.com/fail',
                                callback_url='http://callbackurl.com/callback'
                                )
    #To see code returned
    print(response)
    return response

Tests

Running tests

python setup.py test