This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.
This package is abandoned and no longer maintained. No replacement package was suggested.

Laravel package for Big Commerce PHP API

2.0.0 2015-07-31 19:34 UTC

This package is not auto-updated.

Last update: 2020-11-13 20:18:07 UTC


A wrapper package for the Bigcommerce PHP API.

Package Installation

Add the following line to your composer.json file:

"kalley/laravel-bigcommerce": "dev-master"

or run composer require kalley/laravel-bigcommerce:dev-master from the command line

Add this line of code to the providers array located in your app/config/app.php file:


And this lines to the aliases array:

'Bigcommerce' => 'Kalley\LaravelBigcommerce\Client',


In order to use the Bigcommerce API, publish its configuration first

php artisan config:publish kalley/laravel-bigcommerce

Afterwards edit the file app/config/packages/kalley/laravel-bigcommerce/bigcommerce.php to suit your needs.


This package comes with all the migrations you need to run a full featured oauth2 server. Run:

php artisan bigcommerce:migrations

Then you're ready to go! Look at the Bigcommerce PHP API for specifics on how to use the library.


This library will cache the results of any GET API calls if you configure it to. This will always cache the results of the added methods unless you pass false as the final argument.

The cache configuration option accepts an integer representing minutes (eg. 10); false, null, 0 to not cache; or 'forever' to cache forever. Any other value will be treated as a sign to not cache the result. As with the added methods below, you can pass a boolean as the final argument to force it to cache again if you wish.


This library passes existing Bigcommerce\Api\Client methods through while caching (if configured to do so) the results. It also includes the following methods:

Bigcommerce::createCustomerAddress($customer_id, $object);

This will create an address in the customer's address book in your store. Required fields are as followed:

  • first_name
  • last_name
  • phone
  • street_1
  • city
  • state
  • zip
  • country - this needs to match exactly what Bigcommerce is expecting. See below.
Bigcommerce::getCountries($filter=false, $force=false);

This will give you a list of countries Bigcommerce supports or whatever. Caches it for you so you don't use up your API limit.

Returns an array of \Bigcommerce\Api\Resource


If, for whatever reason, you want information on a single country.

Returns an instance of \Bigcommerce\Api\Resource

Bigcommerce::getCountryStates($country_id, $filter=false, $force=false);

Get states/provinces for the requested country. Caches it for you so you don't use up your API limit.

Returns an array of \Bigcommerce\Api\Resource

Bigcommerce::getCountryState($country_id, $id);

If, for whatever reason, you want information on a single state.

Returns an instance of \Bigcommerce\Api\Resource


Bugs and feature request are tracked on GitHub


This package is released under the MIT License.