README

This library is based on the PHP TaxCloud library by VMDoh. It introduces support for tax exemptions and brings the original library up-to-date with the most recent version of the TaxCloud API.

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.

About

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

Compatibility

php-taxcloud is tested with PHP 7.4 and later.

Contributions

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.

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.

Examples

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.

Testing

A smoketest is 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

DO NOT RUN THE SMOKETEST WITH CREDENTIALS FOR A LIVE SITE. IT WILL CREATE TRANSACTIONS

bporcelli / php-taxcloud

Maintainers

Details