Finix Python Library

At this time, the Finix Python SDK is not receiving regular updates or improvements. We plan on releasing a new version of our Python SDK in the near future. If you have any questions, please reach out to the Finix Support Team.

Installation

While we fine-tune and make changes, we've paused releasing updates since 09/20/2022. If you have any questions, feel free to reach out to the Finix Support Team.

Prerequisites

• Python>=3.6

install from PyPI:

pip install --upgrade finix

install from source:

python setup.py install

Using the Library

Initialization

import finix
from finix.configuration import Environment, Configuration
from finix.models import *        
# finix.models is intended for wildcard import, feel safe to import all predefined models at once

config = Configuration(
    username = 'ENTER_YOUR_USERNAME',
    password = 'ENTER_YOUR_PASSWORD',
    environment = Environment.SANDBOX
)

client = finix.FinixClient(config)

Example APIs

Here is an example of creating a transfer:

request = CreateTransferRequest(
    merchant='MUeDVrf2ahuKc9Eg5TeZugvs',
    currency = Currency("USD"),
    amount = 12345,
    source = 'PIe2YvpcjvoVJ6PzoRPBK137',
    tags = Tags(
        category = 'sale'
    )
)

transfer = client.transfers.create(create_transfer_request=request)

Here is an example of listing payment instruments:

# fetch 5 payment instruments and print id of each
payment_instruments = client.payment_instruments.list(limit=5)
for single_instrument in payment_instruments:
    print(single_instrument.id)

# fetch the next 5 payment instruments and print type of the first one
next_five_instruments = payment_instruments.list_next()
print(next_five_instruments[0].type)

Here is an example of catching exceptions:

try:
    client.payment_instruments.get('this_is_invalid_id')

except finix.ApiException as e:
    # print basic http information of the exception
    print(e.status)
    print(e.reason)
    print(e.headers)
    # print message of each error in the http response body
    for err in e.body:
        print (err.message)

Supported APIs

• Transfers
• Authorizations
• Identities
• Merchants
• Payment Instruments
• Instrument Updates
• Balance Transfers
• Devices
• Disputes
• Files
• Settlements
• Webhooks
• Verifications
• Merchant Profiles
• Fee Profiles
• Onboarding Forms
• Compliance Forms