Skip to main content

A simple Bluefin Payment System API.

Project description

python-bluefin is a Python API client for the Bluefin Payment System API. The only thing this client module does is serialize and pass the data on to the Bluefin API gateway, it performs little to no validation. Values are passed into an API function in dict form, and responses come back in a similar dict format.

Note

python-bluefin is not at all endorsed by Bluefin Payment Systems in any way. We have published this API module with the hope that it will be useful to someone else.

Status

python-bluefin has been in use in production for about a year with a high transaction volume. The directmode client in particular has seen lots of use.

That said, we only use a little sliver of what Bluefin supports (one-off credit card charges, namely). Given that python-bluefin is a very light wrapper, other usage cases should still work just fine, even if we (the maintainers) haven’t used them yet.

Installing

To install:

pip install --upgrade bluefin

A quick example

Here’s a very bare-bones example of how to use the Direct Mode V3Client. We pass in the required key/values via a Python dict, and get a dict result. All of these values are documented in the Bluefin API documentation, so look there for help on just what is being passed in and coming back.

>>> from bluefin.directmode.clients import V3Client
>>> api = V3Client()
>>> result = api.send_request({
    'pay_type': 'C',
    'tran_type': 'A',
    'account_id': 123456789012,
    'amount': 1.0,
    'card_number': 4444333322221111,
    'card_expire': '1212',
    'dynip_sec_code': 'SECURITY_CODE_HERE',
})
>>> print result
{
    'avs_code': 'X', 'auth_msg': 'TEST APPROVED',
    'status_code': 'T', 'ticket_code': 'XXXXXXXXXXXXXXX',
    'auth_date': '2011-06-22 19:04:30', 'settle_currency': 'USD',
    'auth_code': '999999', 'settle_amount': '1', 'cvv2_code': 'M',
    'processor': 'TEST', 'trans_id': '123456789012'
}

Running Unit Tests

  • Install nose.
  • Copy tests/api_details.blank.py to tests/api_details.py
  • Edit test/api_details.py to reflect your account number and security code.
  • From within the python-bluefin dir, run nosetests

License

python-bluefin is licensed under the BSD License.

Project details


Release history Release notifications

This version
History Node

1.4

History Node

1.3

History Node

1.2

History Node

1.1

History Node

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
bluefin-1.4.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Nov 16, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page