2017 © Pedro Peláez
 

library trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

image

cruisedotco/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  • Thursday, January 18, 2018
  • by cruiseco
  • Repository
  • 1 Watchers
  • 0 Stars
  • 283 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 11 Forks
  • 0 Open issues
  • 8 Versions
  • 160 % Grown

The README.md

Trustly PHP Client

This is an example implementation of communication with the Trustly API using PHP. It implements the standard Payments API as well as gives stubs for executing calls against the API used by the backoffice., (*1)

For full documentation on the Trustly API internals visit our developer website: http://trustly.com/developer . All information about software flows and call patters can be found on that site. The documentation within this code will only cover the code itself, not how you use the Trustly API., (*2)

This code is provided as-is, use it as inspiration, reference or drop it directly into your own project and use it., (*3)

If you find problem in the code or want to extend it feel free to fork it and send us a pull request., (*4)

This code should work with PHP 5 (>= 5.2.0). PHP modules needed are: bcmath, openssl, curl, mbstring and json., (*5)

Overview

The code provided wrappers for calling the trustly API. Create an instance of the API call with you merchant criterias and use the stubs in that class for calling the API. The API will default to communicate with https://trustly.com, override the host parameter for the constructor to comminicate with test.trustly.com instead., (*6)

When processing an incoming notification the handleNotification() method of the API will help with parsing and verifying the message signature, use notificationResponse() to build a proper response object, (*7)

The examples below represent a very basic usage of the calls. A minimum of error handling around this code would be to check for the following exceptions during processing., (*8)

  • Trustly_ConnectionException, (*9)

    Thrown when unable to communicate with the Trustly API. This can be due to Internet or other forms of service errors., (*10)

  • Trustly_DataException, (*11)

    Thrown upon various problems with the API returned data. For instance when a responding message contains a different UUID then the sent message or when the response structure is incomplete., (*12)

  • Trustly_SignatureException, (*13)

    Issued when the authenticity of messages cannot be verified. If ever this exception is caught the data in the communication should be voided as it can be a forgery., (*14)

Example deposit call

require_once('Trustly.php');

/* Change 'test.trustly.com' to 'trustly.com' below to use the live environment */
$api = new Trustly\Api\Trustly_Api_Signed(
                $trustly_rsa_private_key,
                $trustly_username,
                $trustly_password,
                'test.trustly.com'
            );

/* Guzzle will handle our remote requests. */
$api->setGuzzle(new \GuzzleHttp\Client());

$deposit = $api->deposit(
                "$base_url/php/example.php/notification",   /* NotificationURL */
                'john.doe@example.com',                     /* EndUserID */
                $messageid,                                 /* MessageID */
                'en_US',                                    /* Locale */
                $amount,                                    /* Amount */
                $currency,                                  /* Currency */
                'SE',                                       /* Country */
                NULL,                                       /* MobilePhone */
                NULL,                                       /* FirstName */
                NULL,                                       /* LastName */
                NULL,                                       /* NationalIdentificationNumber */
                'Test',                                     /* ShopperStatement */
                $ip,                                        /* IP */
                "$base_url/success.html",                   /* SuccessURL */
                "$base_url/fail.html",                      /* FailURL */
                NULL,                                       /* TemplateURL */
                "0",                                        /* URLTarget */
                NULL,                                       /* SuggestedMinAmount */
                NULL,                                       /* SuggestedMaxAmount */
                'trustly-client-php example/1.0'            /* IntegrationModule */
                FALSE,                                      /* HoldNotifications */
                'john.doe@example.com',                     /* Email */
                'SE',                                       /* ShippingAddressCountry */
                '12345',                                    /* ShippingAddressPostalCode */
                'ExampleCity',                              /* ShippingAddressCity */
                '123 Main St'                               /* ShippingAddressLine1 */
                'C/O Careholder',                           /* ShippingAddressLine2 */
                NULL                                        /* ShippingAddress */
            );

$iframe_url= $deposit->getData('url');

Example notification processing

$request = $api->handleNotification($notification_body);
    # FIXME Handle the incoming notification data here
$notifyresponse = $api->notificationResponse($request, TRUE);

echo $notifyresponse->json();

Example implementation

In the example/ subdirectory is a simple implementation of a client that uses the code to make a deposit call to Trustly and processes incoming notifications. The code is well commented and contains information about what to calls that needs to be made and some caveats while doing so., (*15)

Use the built-in php webserver to give it a go (php -S localhost:8000 in the example/www directory). You need to amend example/www/php/example.php and example/example.private.pem to contain your processing account information before giving it a test spin., (*16)

Contribution / Development

Feel free to raise a pull request for changes that you may need. Any changes coming in would need to be covered with unit tests., (*17)

Thanks very much, happy open sourcing., (*18)

The Versions

18/01 2018

dev-master

9999999-dev http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

18/01 2018

1.0.4

1.0.4.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

08/01 2018

1.0.3

1.0.3.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

03/01 2018

1.0.2

1.0.2.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

02/01 2018

1.0.1

1.0.1.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

02/01 2018

1.0.0

1.0.0.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

 

The Development Requires

payment trustly

27/12 2017

0.1.1

0.1.1.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

  • ext-json *
  • ext-bcmath *
  • ext-openssl *
  • ext-curl *
  • ext-mbstring *
  • php >=5.2.0

 

payment trustly

15/11 2017

0.1.0

0.1.0.0 http://github.com/trustly/trustly-client-php

Implementation of communications with Trustly public API for Online bank e-payments. See https://trustly.com for more information

  Sources   Download

The Requires

  • ext-json *
  • ext-bcmath *
  • ext-openssl *
  • ext-curl *
  • ext-mbstring *
  • php >=5.2.0

 

payment trustly