Billie PHP SDK

The Billie PHP SDK enables you to integrate the REST API of Billie easily and quickly into an existing code base and to use it.

Requirements

PHP 7.4 or higher
cURL (included and enabled in a standard PHP distribution)
OpenSSL (included and enabled in a standard PHP distribution)

You need a Billie account to receive the necessary credentials.

Installation with Composer

You can use the Billie PHP SDK library as a dependency in your project with Composer (preferred technique).

Follow these installation instructions if you do not already have Composer installed. A composer.json file is available in the repository, and it has been referenced from Packagist.

To install the SDK, just execute the following command:

composer require billie/api-php-sdk

Usage

General usage

For every request there is a

request service (instance of \Billie\Sdk\Service\Request\AbstractRequest) Knows anything about the request itself (url, method, authorization)
request model (instance of \Billie\Sdk\Model\Response\AbstractRequestModel) Knows anything about the parameters of the request, and acts as DTO to submit the data to the request service
response model (instance of \Billie\Sdk\Model\Response\AbstractResponseModel) Knows anything about the response data, and acts as DTO to receives the data from the request service Note: in some cases there is not response. Just a true if the request was successful

Get a `\Billie\Sdk\HttpClient\BillieClient`-instance

Use the \Billie\Sdk\Util\BillieClientFactory to get a new instance.

The factory will automatically request a new auth-token from the gateway and will store it (with the whole instance) in a static variable. So it will not produce a new request, if you request a new BillieClient-instance.

$isSandbox = true;
$billieClient = \Billie\Sdk\Util\BillieClientFactory::getBillieClientInstance('YOUR-CLIENT-ID', 'YOUR-CLIENT-SECRET', $isSandbox);

Provide a boolean as third parameter to define if the request goes against the sandbox or not.

Get an instance of a request service

You can simply create a new instance of the corresponding class.

Example:

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient **/

$requestService = new \Billie\Sdk\Service\Request\Order\CreateOrderRequest($billieClient);

You must not provide the BillieClient via the constructor, but you should set it, before calling execute on the request service.

Example:

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient **/

$requestService = new \Billie\Sdk\Service\Request\Order\CreateOrderRequest();
// [...]
$requestService->setClient($billieClient);
// [...]
$requestService->execute(...);

Models

Request models: Validation

Every field of a request model (not response models) will be validated automatically, during calling its setter. If you provide a wrong value or in an invalid format, an \Billie\Sdk\Exception\Validation\InvalidFieldException will be thrown.

You can disable this automatic validation, by calling the method setValidateOnSet on the model:

/** @var \Billie\Sdk\Model\Request\AbstractRequestModel $requestModel */

$requestModel->setValidateOnSet(false);

The model got validate at least by the request service, to make sure that all data has been provided, and you will get no validation exception through the gateway.

Response models

Every response model is set to be read-only.

You can not set any fields on this model. You will get a BadMethodCallException.

Requests

This documentation should not explain the whole usage of each request. It should only show the main information about each request, and the main usage.

GetTokenRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Auth\GetTokenRequest`
Request model	`\Billie\Sdk\Model\Request\Auth\GetTokenRequestModel`
Response model	`\Billie\Sdk\Model\Response\Auth\GetTokenResponseModel`

With this service you can create a new auth-token for your credentials.

This service got called automatically, if you use the \Billie\Sdk\Util\BillieClientFactory to get the BillieClient.

This request service is the only one, which do NOT need a BillieClient-instance.

Usage

$isSandbox = true;
$tokenRequestService = new \Billie\Sdk\Service\Request\Auth\GetTokenRequest($isSandbox);

$requestModel = new \Billie\Sdk\Model\Request\Auth\GetTokenRequestModel();
$requestModel
    ->setClientId('YOUR-CLIENT-ID')
    ->setClientSecret('YOUR-SECRET-ID');
    
/** @var \Billie\Sdk\Model\Response\Auth\GetTokenResponseModel */
$responseModel = $tokenRequestService->execute($requestModel);
$accessToken = $responseModel->getAccessToken(); // use this token for further requests.

ValidateTokenRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Auth\ValidateTokenRequest`
Request model	`\Billie\Sdk\Model\Request\Auth\ValidateTokenRequestModel`
Response model	`\Billie\Sdk\Model\Response\Auth\ValidateTokenResponse`

Use this service to verify if your token is still valid. If the token is not valid anymore, you have to request a new auth-token.

If the token is valid, you will get a response. Otherwise, you will get an \Billie\Sdk\Exception\UserNotAuthorizedException.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$validateTokenRequest = new \Billie\Sdk\Service\Request\Auth\ValidateTokenRequest($billieClient);

/** @var \Billie\Sdk\Model\Response\Auth\ValidateTokenResponse $responseModel */
$responseModel = $validateTokenRequest->execute(new \Billie\Sdk\Model\Request\Auth\ValidateTokenRequestModel());

Note: the request model does not have any content. Don't be confused.

RevokeTokenRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Auth\RevokeTokenRequest`
Request model	`\Billie\Sdk\Model\Request\Auth\RevokeTokenRequestModel`
Response model	`true`

Use this service to revoke the token. The token should be already stored in the Billie-Client instance.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$validateTokenRequest = new \Billie\Sdk\Service\Request\Auth\RevokeTokenRequest($billieClient);

/** @var bool $responseModel */
$responseModel = $validateTokenRequest->execute(new \Billie\Sdk\Model\Request\Auth\RevokeTokenRequestModel());

Note: the request model does not have any content. Don't be confused.

CreateSessionRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\CheckoutSession\CreateSessionRequest`
Request model	`\Billie\Sdk\Model\Request\CheckoutSession\CreateSessionRequestModel`
Response model	`\Billie\Sdk\Model\Response\CreateSessionResponseModel`

Use this service to create a new checkout session on the gateway for the customer.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\CheckoutSession\CreateSessionRequest($billieClient);

$requestModel = new \Billie\Sdk\Model\Request\CheckoutSession\CreateSessionRequestModel();
$requestModel->setMerchantCustomerId('THE-NUMBER-OR-ID-OF-THE-CUSTOMER');

/** @var \Billie\Sdk\Model\Response\CreateSessionResponseModel $responseModel */
$responseModel = $requestService->execute($requestModel);

$checkoutSessionId = $responseModel->getCheckoutSessionId(); // use this session ID and submit it to the widget.

CheckoutSessionConfirmRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\CheckoutSession\CheckoutSessionConfirmRequest`
Request model	`\Billie\Sdk\Model\Request\CheckoutSession\CheckoutSessionConfirmRequestModel`
Response model	`\Billie\Sdk\Model\Order`

If the user has confirmed the payment (through the widget), you can confirm the order.

It will create an order finally on the gateway.

Note: Please have a look into each model, which field has to be submitted.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\CheckoutSession\CheckoutSessionConfirmRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\CheckoutSession\CheckoutSessionConfirmRequestModel();
$requestModel
  ->setSessionUuid('CHECKOUT-SESSION-ID')
  ->setCompany(new \Billie\Sdk\Model\Request\CheckoutSession\Confirm\Debtor())
  ->setAmount(new \Billie\Sdk\Model\Amount())
  ->setDuration(14)
  ->setDeliveryAddress(new \Billie\Sdk\Model\Address());
  
/** @var \Billie\Sdk\Model\Order $responseModel */
$responseModel = $requestService->execute($requestModel); // this is the finally created order

GetCheckoutAuthorizationRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\CheckoutSession\GetCheckoutAuthorizationRequestModel`
Request model	`\Billie\Sdk\Model\Request\CheckoutSession\CheckoutSessionConfirmRequestModel`
Response model	`\Billie\Sdk\Model\Request\CheckoutSession\GetCheckoutAuthorizationResponseModel`

Use this service to fetch the details about the authorized current checkout-session.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\CheckoutSession\GetCheckoutAuthorizationRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\CheckoutSession\GetCheckoutAuthorizationRequestModel();
$requestModel
  ->setSessionUuid('CHECKOUT-SESSION-ID');
  
/** @var \Billie\Sdk\Model\Response\CheckoutSession\GetCheckoutAuthorizationResponseModel $responseModel */
$responseModel = $requestService->execute($requestModel);

CreateOrderRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Order\CreateOrderRequest`
Request model	`\Billie\Sdk\Model\Request\Order\CreateOrderRequestModel`
Response model	`\Billie\Sdk\Model\Order`

This request should be only used, if the seller creates the order manually (telephone, api, ...)

It will create a new order with the initial state of created without displaying a widget to confirm.

Note: Please have a look into each model, which field has to be submitted.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Order\CreateOrderRequest($billieClient);

$requestModel = new \Billie\Sdk\Model\Request\Order\CreateOrderRequestModel();
$requestModel
    ->setAmount(new \Billie\Sdk\Model\Amount())
    ->setDuration(12)
    ->setDebtor(new \Billie\Sdk\Model\Request\Order\CreateOrder\Debtor())
    ->setPerson(new \Billie\Sdk\Model\Person())
    ->setComment('order comment')
    ->setExternalCode('merchant-order-number')
    ->setDeliveryAddress(new \Billie\Sdk\Model\Address())
    ->setLineItems([
        new \Billie\Sdk\Model\LineItem(),
        new \Billie\Sdk\Model\LineItem(),
    ])
    
/** @var \Billie\Sdk\Model\Order $responseModel */
$responseModel = $requestService->execute($requestModel); // this is the finally created order

This service will throw the following exceptions, which should be handled by the integration:

Billie\Sdk\Exception\OrderDecline\DebtorLimitExceededException - the debtor-limit has been exceeded.
Billie\Sdk\Exception\OrderDecline\DebtorNotIdentifiedException - the gateway was not able to identify the debtor
Billie\Sdk\Exception\OrderDecline\InvalidDebtorAddressException - the gateway was not able to verify the address
Billie\Sdk\Exception\OrderDecline\RiskPolicyDeclinedException - the order got declined for risk reasons
Billie\Sdk\Exception\OrderDecline\OrderDeclinedException - the order got declined by any other reasons

UpdateOrderRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Order\UpdateOrderRequest`
Request model	`\Billie\Sdk\Model\Request\Order\UpdateOrderRequestModel`
Response model	`true`

Use this order, to update information about the order. Please have a look into the api documentation, which fields are updatable. Please also have a look into each model, to find out, which fields this sdk can process.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Order\UpdateOrderRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\Order\UpdateOrderRequestModel('REFERENCE-ID');
$requestModel
  ->setExternalCode('SHOP-ORDER-NUMBER')
  ->setAmount(new \Billie\Sdk\Model\Amount());
  
/** @var true $success */
$success = $requestService->execute($requestModel); // true if successful

GetOrderRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\GetOrderRequest`
Request model	`\Billie\Sdk\Model\Request\OrderRequestModel`
Response model	`\Billie\Sdk\Model\Order`

Use this service to retrieve all order information

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Order\GetOrderRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\OrderRequestModel('REFERENCE-ID');

/** @var \Billie\Sdk\Model\Order $responseModel */
$responseModel = $requestService->execute($requestModel);

CreateInvoiceRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\CreateInvoiceRequest`
Request model	`\Billie\Sdk\Model\Request\Invoice\CreateInvoiceRequestModel`
Response model	`\Billie\Sdk\Model\Response\CreateInvoiceResponseModel`

Use this service to retrieve all order information

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\CreateInvoiceRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\Invoice\CreateInvoiceRequestModel();
$requestModel
    ->setOrders(['REFERENCE-ID']) // use this method to set Billie reference-id or merchants order-number
    ->setOrderUuId('REFERENCE-UD') // use this method to set Billie reference-id
    ->setOrderExternalCode('MERCHANT_ORDER_ID') // use this method to set merchants order-number
    // to keep your code clean, only use one of the above methods
    ->setInvoiceNumber('merchant-invoice-number')
    ->setInvoiceUrl('https://public-url.com/to/to/merchant-invoice.pdf')
    ->setAmount(
        (new Amount())
            ->setGross(100)
            ->setTaxRate(19.00)
    )
    // optional parameters:
    ->setLineItems([
        new \Billie\Sdk\Model\Request\Invoice\LineItem('merchant-product-id-2', 1),
        new \Billie\Sdk\Model\Request\Invoice\LineItem('merchant-product-id-1', 2)  
    ])
    ->setShippingInformation(new \Billie\Sdk\Model\ShippingInformation())

/** @var \Billie\Sdk\Model\Response\CreateInvoiceResponseModel $responseModel */
$responseModel = $requestService->execute($requestModel);
$uuid = $responseModel->getUuid(); // uuid of the invoice

GetInvoiceRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\GetInvoiceRequest`
Request model	`\Billie\Sdk\Model\Request\InvoiceRequestModel`
Response model	`\Billie\Sdk\Model\Response\CreateInvoiceResponseModel`

Use this service to fetch an invoice.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\GetInvoiceRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\InvoiceRequestModel('INVOICE-UUID');

/** @var \Billie\Sdk\Model\Invoice $responseModel */
$responseModel = $requestService->execute($requestModel);

UpdateInvoiceRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\UpdateInvoiceRequest`
Request model	`\Billie\Sdk\Model\Request\Invoice\UpdateInvoiceRequestModel`
Response model	`true`

Use this service to update the invoice number or url.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\UpdateInvoiceRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\Invoice\UpdateInvoiceRequestModel('INVOICE-REFERENCE-UUID');
$requestModel
    ->setInvoiceNumber('merchant-invoice-number')
    ->setInvoiceUrl('https://public-url.com/to/to/merchant-invoice.pdf');

if ($requestService->execute($requestModel)) {
    // invoice has been updated
}

CancelInvoiceRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\CancelInvoiceRequest`
Request model	`\Billie\Sdk\Model\Request\InvoiceRequestModel`
Response model	`true`

Use this service to cancel the invoice.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\CancelInvoiceRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\InvoiceRequestModel('INVOICE-REFERENCE-UUID');

if ($requestService->execute($requestModel)) {
    // invoice has been deleted/canceled
}

CreateCreditNoteRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\CreateCreditNoteRequest`
Request model	`\Billie\Sdk\Model\Request\Invoice\CreateCreditNoteRequestModel`
Response model	`\Billie\Sdk\Model\Response\CreateCreditNoteResponseModel`

Use this service to add a (partial) refund/credit-note to an invoice

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\CreateCreditNoteRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\Invoice\CreateCreditNoteRequestModel('INVOICE-UUID', 'MERCHANT/EXTERNAL_CREDIT_NOTE_NUMBER');
$requestModel
    ->setAmount(
        (new Amount())
            ->setGross(100)
            ->setTaxRate(19.00)
    )
    // optional parameters:
    ->setLineItems([
        new \Billie\Sdk\Model\Request\Invoice\LineItem('merchant-product-id-2', 1),
        new \Billie\Sdk\Model\Request\Invoice\LineItem('merchant-product-id-1', 2)  
    ])
    ->setComment('custom comment for refund')

/** @var \Billie\Sdk\Model\Response\CreateInvoiceResponseModel $responseModel */
$responseModel = $requestService->execute($requestModel);
$uuid = $responseModel->getUuid(); // uuid of the invoice

ConfirmPaymentRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Invoice\ConfirmPaymentRequest`
Request model	`\Billie\Sdk\Model\Request\Invoice\ConfirmPaymentRequestModel`
Response model	`true`

Use this request to notify the gateway about a received payment.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Invoice\ConfirmPaymentRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\Invoice\ConfirmPaymentRequestModel('INVOICE-UUID');
$requestModel
    ->setPaidAmount(250);

/** @var true $success */
$success = $requestService->execute($requestModel);

CancelOrderRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\Order\CancelOrderRequest`
Request model	`\Billie\Sdk\Model\Request\OrderRequestModel`
Response model	`true`

Use this request to cancel the order completely.

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\Order\CancelOrderRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\OrderRequestModel('REFERENCE-ID');

/** @var true $success */
$success = $requestService->execute($requestModel);

GetLegalFormsRequest


Api documentation	Link
Request service	`\Billie\Sdk\Service\Request\GetLegalFormsRequest`
Request model	`\Billie\Sdk\Model\Request\GetLegalFormsRequestModel`
Response model	`\Billie\Sdk\Model\Response\GetLegalFormsResponseModel`

Use this request to get all legal forms supported by Billie.

Note: This request is always cached. So you can use it anytime without making a new request against the gateway. The cache will be automatically flushed.

Usage

/** @var \Billie\Sdk\HttpClient\BillieClient $billieClient */

$requestService = new \Billie\Sdk\Service\Request\GetLegalFormsRequest($billieClient);
$requestModel = new \Billie\Sdk\Model\Request\GetLegalFormsRequestModel();

/** @var \Billie\Sdk\Model\Response\GetLegalFormsResponseModel $responseModel */
$responseModel = $requestService->execute($requestModel);

Note: the request model does not have any content. Don't be confused.

Integration utilities

AddressHelper

Class: \Billie\Util\AddressHelper Use this class to separate the house number from the street name.

Usage

$streetName = \Billie\Util\AddressHelper::getStreetName('Musterstraße 123'); // will return "Musterstraße"
$houseNumber = \Billie\Util\AddressHelper::getHouseNumber('Musterstraße 123'); // will return "123"

Further features

Automatic tax amount calculation

Model: \Billie\Sdk\Model\Amount

The model has field called tax. It contains the tax-amount of the line-item/order

To keep the calculations as simple as possible, you can omit the parameter tax. So you must not provide all information. The model will calculates itself.

Example 1:

$amount = new \Billie\Sdk\Model\Amount();
$amount->setGross(119);
$amount->setNet(100);

$tax = $amount->getTax(); // will return `19`

Example 2:

$amount = new \Billie\Sdk\Model\Amount();
$amount->setGross(119);
$amount->setTaxRate(19);

$tax = $amount->getTax(); // will return `19`

Example 3:

$amount = new \Billie\Sdk\Model\Amount();
$amount->setNet(100);
$amount->setTaxRate(19);

$tax = $amount->getTax(); // will return `19`
$gross = $amount->getGross(); // will return `119`

Example 4:

$amount = new \Billie\Sdk\Model\Amount();
$amount->setGross(119);
$amount->setTaxRate(19);

$tax = $amount->getTax(); // will return `19`
$net = $amount->getNet(); // will return `100`

Example 4 (wrong usage):

If you set the tax manually the model will not calculate the values. It will submit the values, as you provide it.

This will end up, that the gateway will give you an error, cause invalid data.

$amount = new \Billie\Sdk\Model\Amount();
$amount->setGross(119);
$amount->setNet(30);
$amount->setTax(40);

$amount->getGross(); // will return `119`
$amount->getNet(); // will return `30`
$amount->getTax(); // will return `40`

Symfony services

If you use a Symfony based system, you can use the request services as a service. So you can inject it very easily. Just register the request services in your services.xml (or yaml)

<?xml version="1.0" ?>
<container xmlns="http://symfony.com/schema/dic/services"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
    <services>
        <service id="Billie\Sdk\Service\Request\CheckoutSession\CreateSessionRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\Order\CancelOrderRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\CheckoutSession\CheckoutSessionConfirmRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\Order\CreateOrderRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\GetLegalFormsRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\GetOrderRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\Order\UpdateOrderRequest" autowire="true"/>
        <service id="Billie\Sdk\Service\Request\ConfirmPaymentRequest" autowire="true"/>
    </services>
</container>

You can just inject the request services to your classes.

Example:

<?php
namespace YourNamespace;

class MyClass
{

    /**
     * @var \Billie\Sdk\Service\Request\AbstractRequest
     */
    private $requestService;
    
    public function __construct(\Billie\Sdk\Service\Request\AbstractRequest $requestService) 
    {
        $this->requestService = $requestService;
    }
    
    public function process()
    {
        $response = $this->requestService->execute(...);
    }
}

Create BillieClient via a factory

Do not forget to define a factory for your \Billie\Sdk\HttpClient\BillieClient-instance to get the Client injected into the request service:

<?xml version="1.0" ?>
<container xmlns="http://symfony.com/schema/dic/services"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
    <services>
        <service id="YourNamespace\BillieClientFactory"/>
        <service id="Billie\Sdk\HttpClient\BillieClient">
            <factory service="YourNamespace\BillieClientFactory" method="createBillieClient"/>
        </service>
    </services>
</container>

<?php
namespace YourNamespace;

class BillieClientFactory
{
    public function createBillieClient()
    {
        $isSandbox = true;
        return \Billie\Sdk\Util\BillieClientFactory::getBillieClientInstance(
            'YOUR-CLIENT-ID',
            'YOUR-CLIENT-SECRET',
            $isSandbox
        );
    }
}

Provide BillieClient via setter

If you can not use the factory to create an instance of \Billie\Sdk\HttpClient\BillieClient, you can also set the BillieClient manually to the request service:

/* @var \Billie\Sdk\Service\Request\AbstractRequest $requestService */
$isSandbox = true;
$requestService->setClient(new \Billie\Sdk\HttpClient\BillieClient('YOUR-CLIENT-ID', 'YOUR-CLIENT-SECRET', $isSandbox));

Logging

You can enable logging for all API requests (we may extend this functionality to log additional events in the future).

To activate logging, simply provide us with an instance of \Psr\Log\LoggerInterface. A commonly used logger is the monolog/monolog package.

Please note that only loggers implementing the mentioned interface can be passed. If you are using a custom logger, ensure that it implements the LoggerInterface. Also, don't forget to install the psr/log package if it’s not already included.

Important: Do not configure a debug logger in production, as this will log all requests (successful and failed). If you only want to log failed requests, configure the logger to handle only ERROR level events.

Example:

$logFile = '/path/to/your/logfile.log';
$logger = new \Monolog\Logger('name-for-the-logger');

// handler for errors
$handlerDebug = new \Monolog\Handler\StreamHandler('/path/to/your/log-file.debug.log', LogLevel::DEBUG);
$logger->pushHandler($handlerDebug);

// handler for debug-information
$handlerError = new \Monolog\Handler\StreamHandler('/path/to/your/log-file.error.log', LogLevel::ERROR);
$logger->pushHandler($handlerError);

\Billie\Sdk\Util\Logging::setPsr3Logger($logger);
// call this if you want to log the request-headers too
\Billie\Sdk\Util\Logging::setLogHeaders(true);

Files

README.md

Latest commit

History

README.md

File metadata and controls

Billie PHP SDK

Requirements

Installation with Composer

Usage

General usage

Get a \Billie\Sdk\HttpClient\BillieClient-instance

Get an instance of a request service

Models

Request models: Validation

Response models

Requests

GetTokenRequest

ValidateTokenRequest

RevokeTokenRequest

CreateSessionRequest

CheckoutSessionConfirmRequest

GetCheckoutAuthorizationRequest

CreateOrderRequest

UpdateOrderRequest

GetOrderRequest

CreateInvoiceRequest

GetInvoiceRequest

UpdateInvoiceRequest

CancelInvoiceRequest

CreateCreditNoteRequest

ConfirmPaymentRequest

CancelOrderRequest

GetLegalFormsRequest

Integration utilities

AddressHelper

Further features

Automatic tax amount calculation

Symfony services

Create BillieClient via a factory

Provide BillieClient via setter

Logging

Get a `\Billie\Sdk\HttpClient\BillieClient`-instance