TaxCloud PHP library

Installs: 1 872

Dependents: 1

Stars: 4

Watchers: 2

Forks: 4

Open Issues: 2

v0.1.1 2013-12-10 10:20 UTC


Latest Stable Version Total Downloads Build Status Coverage Status

At this point, most of the functionality needed to complete an order has been implemented. The only feature left to fully test and implement is exemptions.

A smoketest is provided that connects to the TaxCloud API using credentials stored in environment variables. It is intended for quick tests to ensure that the core of the library works, but it is not a thorough test. DO NOT RUN THE SMOKETEST WITH CREDENTIALS FOR A LIVE SITE. IT WILL CREATE TRANSACTIONS.

The smoketest also provides an excellent set of examples on how to use this library.

PHP library to facilitate the ability of your PHP web application to communicate with TaxCloud.


php-taxcloud is tested with PHP 5.3 and later.


If you'd like to help with php-taxcloud, your efforts are appreciated!

However, your code should at least somewhat closely follow PSR-2 guidelines, and API changes should be accompanied by tests.

Getting Started

This library requires that you have API credentials for TaxCloud and USPS.

To obtain TaxCloud API keys, you will need to first sign up for an account with TaxCloud, verify your website, and then obtain your API ID and API KEY for your specific website.

To obtain a USPS Web Tools User ID, you will need to fill out the form here. You will receive an email with a Username and Password. All you need is the Username.

If you already have some sort of address verification in place, the USPS Web Tools User ID is optional. What is important is that you have accurate ZIP+4 codes for your addresses for taxation purposes.


The smoketest is a great resource for a working example that goes through the entire process in a basic and straightforward manner. The unit tests are a much better resource if you need to see how specific functionality works. The unit tests use stubs to mock the API, and these stubs can show you what sort of data to expect.


php-taxcloud includes thorough unit tests that do not require a live connection to the API. If you are contributing to php-taxcloud, please include unit tests for your contributions.

Travis-ci runs unit tests for the repository. However, you can run them locally with PHPUnit.

A smoketest is also included that connects to the API and is intended only for a very quick check that basic functionality has not been broken. To use the smoketest, you will need to set the following environment variables:

  • TaxCloud_apiLoginID
  • TaxCloud_apiKey
  • TaxCloud_uspsUserID