Installing Merchant

You can use any of the following methods to install merchant.

  • The recommended way is to install from PyPi:

    pip install django-merchant
  • If you are feeling adventurous, you might want to run the code off the git repository:

    pip install -e git+git://


  • Install the dependencies for the gateways as prescribed in the individual gateway doc.
  • Reference the billing app in your settings INSTALLED_APPS.
  • Run python syncdb to create the new required database tables


To configure a gateway/integration add the corresponding key to MERCHANT_SETTINGS. Take a look at for reference.

Running the Test Suite

By default, the test suite is configured to run tests for all the gateways and integrations which are configured:

python test billing

Tests for gateways and integrations which are not configured will be skipped.

If you are planning to integrate your app with a specific gateway/integration then you might wish to run only that apps test suite. For example, to run the Google Checkout Integration test case:

python test billing.GoogleCheckoutTestCase