PHPackages                             billbee/foreign-systems-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. billbee/foreign-systems-sdk

ActiveLibrary[API Development](/categories/api)

billbee/foreign-systems-sdk
===========================

The SDK for connecting foreign systems to Billbee

v1.0.0-beta(1y ago)02MITPHP

Since Jul 31Pushed 1y ago1 watchersCompare

[ Source](https://github.com/billbeeio/foreign-systems-sdk-php)[ Packagist](https://packagist.org/packages/billbee/foreign-systems-sdk)[ RSS](/packages/billbee-foreign-systems-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (8)Versions (3)Used By (0)

Foreign Systems API
===================

[](#foreign-systems-api)

This is the PHP SDK for the **upcoming** Billbee Foreign Systems API.

The Foreign Systems API will supersede the Custom Shop API since it is more flexible and provides a better developer experience.

Differences to the Custom Shop API
----------------------------------

[](#differences-to-the-custom-shop-api)

The Custom Shop API supports, as the name says, only webshops and marketplaces. The Foreign Systems API is designed to support other systems as well. At the moment only web shops and marketplaces are supported, but we will support shipping systems, payment systems and other systems in the future.

To achieve this, we moved a bit of logic from our side to the implementors side. The first API call we make is a provisioning call. This call is used to query all supported features on your end plus configuration details such as authorization method and HTTP Headers.

Your system need to post the [ProvisioningDetails](./src/Provisioning/Contracts/ProvisioningDetails.php) to the URL given in the call we made.

The further communication is quite similar to the old Custom Shop API.

Installation
------------

[](#installation)

```
composer require billbee/foreign-systems-sdk
```

Usage
-----

[](#usage)

This is the simplest implementation:

```