├── .gitignore
├── .travis.yml
├── README.md
├── composer.json
├── console_demo.php
├── figo
    ├── Account.php
    ├── AccountBalance.php
    ├── Bank.php
    ├── Base.php
    ├── Category.php
    ├── Config.php
    ├── Connection.php
    ├── Exception.php
    ├── HttpsRequest.php
    ├── Notification.php
    ├── Payment.php
    ├── Process.php
    ├── Security.php
    ├── Session.php
    ├── StandingOrder.php
    ├── SynchronizationStatus.php
    ├── Task.php
    ├── Transaction.php
    ├── User.php
    ├── ca-bundle.crt
    └── utils.php
├── phpunit.xml
├── test
    └── FigoTest.php
└── web_demo
    ├── app.php
    ├── index.php
    ├── static
        ├── banking.css
        └── favicon.ico
    └── views
        └── index.twig


/.gitignore:
--------------------------------------------------------------------------------
1 | .idea/
2 | composer.phar
3 | composer.lock
4 | vendor/
5 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: php
2 | php:
3 |   - 5.6
4 |   - 7.0
5 |   - 7.1
6 | before_script: composer install
7 | script: vendor/bin/phpunit
8 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | php-figo [![Build Status](https://secure.travis-ci.org/figo-connect/php-figo.png)](https://travis-ci.org/figo-connect/php-figo) [![Packagist Version](http://img.shields.io/packagist/v/figo/figo.svg)](https://packagist.org/packages/figo/figo)
 2 | ========
 3 | 
 4 | PHP bindings for the figo Connect API: http://docs.figo.io/v3/
 5 | 
 6 | Usage
 7 | =====
 8 | 
 9 | First, you've to add this to your [`composer.json`](http://getcomposer.org/) dependencies:
10 | 
11 | ```
12 | "require": {
13 |   "figo/figo": "1.*"
14 | }
15 | ```
16 | 
17 | and run
18 | 
19 | ```bash
20 | composer update
21 | ```
22 | 
23 | Now you can create a new session and access data:
24 | 
25 | ```php
26 | require_once "vendor/autoload.php";
27 | 
28 | use figo\Session;
29 | 
30 | $session = new Session("ASHWLIkouP2O6_bgA2wWReRhletgWKHYjLqDaqb0LFfamim9RjexTo22ujRIP_cjLiRiSyQXyt2kM1eXU2XLFZQ0Hro15HikJQT_eNeT_9XQ");
31 | 
32 | // Print out list of account numbers and balances.
33 | $accounts = $session->get_accounts();
34 | foreach ($accounts as $account) {
35 |     print($account->account_number."\n");
36 |     print($account->balance->balance."\n");
37 | }
38 | 
39 | // Print out the list of all transaction originators/recipients of a specific account.
40 | $account = $session->get_account("A1.1");
41 | $transactions = $account->get_transactions();
42 | foreach ($transactions as $transaction) {
43 |     print($transaction->name."\n");
44 | }
45 | ```
46 | 
47 | It is just as simple to allow users to login through the API:
48 | 
49 | ```php
50 | require_once "vendor/autoload.php";
51 | 
52 | use figo\Session;
53 | use figo\Connection;
54 | use Eloquent\Liftoff\Launcher;
55 | 
56 | $connection = new Connection("<client ID>", "<client secret>", "http://my-domain.org/redirect-url");
57 | 
58 | function start_login() {
59 |     $launcher = new Launcher;
60 |     $launcher->launch($connection->login_url("qweqwe"));
61 | }
62 | 
63 | function process_redirect($authorization_code, $state) {
64 |     // Handle the redirect URL invocation from the initial start_login call.
65 | 
66 |     // Ignore bogus redirects.
67 |     if ($state !== "qweqwe") {
68 |         return;
69 |     }
70 | 
71 |     // Trade in authorization code for access token.
72 |     $token_dict = $connection->obtain_access_token($authorization_code);
73 | 
74 |     // Start session.
75 |     $session = new Session($token_dict["access_token"]);
76 | 
77 |     // Print out list of account numbers.
78 |     $accounts = $session->get_accounts();
79 |     foreach ($accounts as $account) {
80 |         print($account->account_number."\n");
81 |     }
82 | }
83 | ```
84 | 
85 | Demos
86 | -----
87 | In this repository you can also have a look at a simple console (`console_demo.php`) and web demo (`web_demo` folder).
88 | While the console demo simply accesses the figo API, the web demo implements the full OAuth flow.
89 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "figo/figo",
 3 |   "description": "API wrapper for figo Connect.",
 4 |   "homepage": "https://github.com/figo-connect/php-figo",
 5 |   "version": "3.1.1",
 6 |   "license": "MIT",
 7 |   "autoload": {
 8 |     "psr-0": {
 9 |       "figo": ""
10 |     }
11 |   },
12 |   "require": {
13 |     "php": ">=5.6.0",
14 |     "psr/log": "^1.0.1"
15 |   },
16 |   "require-dev": {
17 |     "phpunit/phpunit": "3.7.*",
18 |     "silex/silex": "~1.2",
19 |     "twig/twig": ">=1.8,<2.0-dev"
20 |   }
21 | }
22 | 


--------------------------------------------------------------------------------
/console_demo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | require_once "vendor/autoload.php";
 3 | 
 4 | use figo\Session;
 5 | 
 6 | $session = new Session("ASHWLIkouP2O6_bgA2wWReRhletgWKHYjLqDaqb0LFfamim9RjexTo22ujRIP_cjLiRiSyQXyt2kM1eXU2XLFZQ0Hro15HikJQT_eNeT_9XQ");
 7 | 
 8 | // Print out list of account numbers and balances.
 9 | $accounts = $session->get_accounts();
10 | foreach ($accounts as $account) {
11 |     print($account->account_number."\n");
12 |     print($account->balance->balance."\n");
13 | }
14 | 
15 | // Print out the list of all transaction originators/recipients of a specific account.
16 | $account = $session->get_account("A1.1");
17 | $transactions = $account->get_transactions();
18 | foreach ($transactions as $transaction) {
19 |     print($transaction->name."\n");
20 | }
21 | 
22 | ?>
23 | 


--------------------------------------------------------------------------------
/figo/Account.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | 
 27 | /**
 28 |  * Object representing one bank account of the user
 29 |  */
 30 | class Account extends Base {
 31 | 
 32 |     protected $dump_attributes = array("name", "owner", "auto_sync");
 33 | 
 34 |     /** @var string Internal figo Connect account ID */
 35 |     public $account_id;
 36 | 
 37 |     /** @var string Internal figo Connect bank ID */
 38 |     public $bank_id;
 39 | 
 40 |     /** @var string Account name */
 41 |     public $name;
 42 | 
 43 |     /** @var string Account owner */
 44 |     public $owner;
 45 | 
 46 |     /** @var boolean This flag indicates whether the account will be automatically synchronized */
 47 |     public $auto_sync;
 48 | 
 49 |     /** @var string Account number */
 50 |     public $account_number;
 51 | 
 52 |     /** @var string Bank code */
 53 |     public $bank_code;
 54 | 
 55 |     /** @var string Bank name */
 56 |     public $bank_name;
 57 | 
 58 |     /** @var string Three-character currency code */
 59 |     public $currency;
 60 | 
 61 |     /** @var string IBAN */
 62 |     public $iban;
 63 | 
 64 |     /** @var string BIC */
 65 |     public $bic;
 66 | 
 67 |     /** @var string Account type */
 68 |     public $type;
 69 | 
 70 |     /** @var string Account icon URL */
 71 |     public $icon;
 72 | 
 73 |     /** @var dict Account icon in other resolutions */
 74 |     public $additional_icons;
 75 | 
 76 |     /** @var boolean This flag indicates whether the balance of this account is added to the total balance of accounts */
 77 |     public $in_total_balance;
 78 | 
 79 |     /** @var SynchronizationStatus Synchronization status object */
 80 |     public $status;
 81 | 
 82 |     /** @var AccountBalance balance of this account */
 83 |     public $balance;
 84 | 
 85 |     /**
 86 |      * Retrieve list of transactions of this account
 87 |      *
 88 |      * @param mixed this parameter can either be a transaction ID or a date
 89 |      * @param integer limit the number of returned transactions
 90 |      * @param integer which offset into the result set should be used to determin the first transaction to return (useful in combination with count)
 91 |      * @param boolean this flag indicates whether pending transactions should be included in the
 92 |      *        response; pending transactions are always included as a complete set, regardless of
 93 |      *        the `since` parameter
 94 |      * @return array an array of <code>Transaction</code> objects, one for each transaction of this account
 95 |      */
 96 |     public function get_transactions($since = null, $count = 1000, $offset = 0, $include_pending = false) {
 97 |         return $this->session->get_transactions($this->account_id, $since, $count, $offset, $include_pending);
 98 |     }
 99 | 
100 |     /**
101 |      * Retrieve specific transaction
102 |      *
103 |      * @param string ID of the transaction to be retrieved
104 |      * @return Transaction transaction object
105 |      */
106 |     public function get_transaction($transaction_id) {
107 |         return $this->session->get_transaction($this->account_id, $transaction_id);
108 |     }
109 | 
110 |     /**
111 |      * Retrieve Bank correspoding to this account
112 |      *
113 |      * @return Bank bank object
114 |      */
115 |     public function get_bank() {
116 |         return $this->session->get_bank($this->bank_id);
117 |     }
118 | 
119 |     /**
120 |      * Retrieve all payments on this account
121 |      *
122 |      * @return array an array of <code>Payment</code> objects
123 |      */
124 |     public function get_payments() {
125 |         return $this->session->get_payments($this->account_id);
126 |     }
127 | 
128 |     /**
129 |      * Retrieve a specific payment on this account
130 |      *
131 |      * @param string ID of the payment to be retrieved
132 |      * @return Payment payment object
133 |      */
134 |     public function get_payment($payment_id) {
135 |         return $this->session->get_payment($this->account_id, $payment_id);
136 |     }
137 | }
138 | 
139 | ?>
140 | 


--------------------------------------------------------------------------------
/figo/AccountBalance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing the balance of a certain bank account of the user
29 |  */
30 | class AccountBalance extends Base {
31 | 
32 |     protected $dump_attributes = array("credit_line", "monthly_spending_limit");
33 | 
34 |     /** @var double Account balance or <code>null</code> if the balance is not yet known */
35 |     public $balance;
36 | 
37 |     /** @var DateTime Bank server timestamp of balance or <code>null</code> if the balance is not yet known */
38 |     public $balance_date;
39 | 
40 |     /** @var double credit line */
41 |     public $credit_line;
42 | 
43 |     /** @var double User-defined spending limit */
44 |     public $monthly_spending_limit;
45 | 
46 |     /** @var SynchronizationStatus Synchronization status object */
47 |     public $status;
48 | }
49 | 
50 | ?>
51 | 


--------------------------------------------------------------------------------
/figo/Bank.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing one bank configured by the user
29 |  */
30 | class Bank extends Base {
31 | 
32 |     protected $dump_attributes = array("sepa_creditor_id");
33 | 
34 |     /** @var string Internal figo Connect bank ID */
35 |     public $bank_id;
36 | 
37 |     /** @var string SEPA direct debit creditor ID */
38 |     public $sepa_creditor_id;
39 | 
40 |     /** @var bool This flag indicates whether the user has chosen to save the PIN on the figo Connect server */
41 |     public $save_pin;
42 | }
43 | 


--------------------------------------------------------------------------------
/figo/Base.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Abstract base class for model objects
29 |  */
30 | class Base {
31 | 
32 |     protected $session;
33 | 
34 |     protected $dump_attributes = array();
35 | 
36 |     /**
37 |      * Constructor
38 |      *
39 |      * @param Session figo <code>Session</code> object
40 |      * @param array use keys of this associative array for model object creation
41 |      */
42 |     public function __construct($session, array $map) {
43 |         $this->session = $session;
44 | 
45 |         foreach ($map as $key => $value) {
46 |             $this->$key = $value;
47 |             if ($key === "status" && is_array($value)) {
48 |                 $this->$key = new SynchronizationStatus($session, $value);
49 |             } elseif ($key === "balance" && is_array($value)) {
50 |                 $this->$key = new AccountBalance($session, $value);
51 |             } elseif (substr($key, -5) === "_date" || substr($key, -10) === "_timestamp") {
52 |                 $this->$key = new \DateTime($value, new \DateTimeZone("UTC"));
53 |             } elseif ($key === "categories" && is_array($value)) {
54 |                 $this->$key = [];
55 |                 foreach ($value as $category) {
56 |                     $this->{$key}[] = new Category($session, $category);
57 |                 }
58 |             } else {
59 |                 $this->$key = $value;
60 |             }
61 |         }
62 |     }
63 | 
64 |     public function dump() {
65 |         $result = array();
66 |         foreach ($this->dump_attributes as $attribute) {
67 |             if (!is_null($this->$attribute)) {
68 |                 $result[$attribute] = $this->$attribute;
69 |             }
70 |         }
71 | 
72 |         return $result;
73 |     }
74 | }
75 | 
76 | ?>
77 | 


--------------------------------------------------------------------------------
/figo/Category.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing one category
29 |  */
30 | class Category extends Base {
31 | 
32 |     /** @var int|null ID of parent category */
33 |     public $parent_id;
34 | 
35 |     /** @var int ID of category */
36 |     public $id;
37 | 
38 |     /** @var string Name of the category */
39 |     public $name;
40 | }
41 | 


--------------------------------------------------------------------------------
/figo/Config.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | 
 27 | /**
 28 |  * Global configuration
 29 |  */
 30 | class Config {
 31 | 
 32 |     /** @var string figo Connect server address. This should be the full base url of the API */
 33 |     public static $API_ENDPOINT = "https://api.figo.me/v3";
 34 | 
 35 |     public static $CA_CERT_BUNDLE = array(
 36 | // Certificate:
 37 | //     Data:
 38 | //         Version: 3 (0x2)
 39 | //         Serial Number:
 40 | //             44:af:b0:80:d6:a3:27:ba:89:30:39:86:2e:f8:40:6b
 41 | //     Signature Algorithm: sha1WithRSAEncryption
 42 | //         Issuer: O=Digital Signature Trust Co., CN=DST Root CA X3
 43 | //         Validity
 44 | //             Not Before: Sep 30 21:12:19 2000 GMT
 45 | //             Not After : Sep 30 14:01:15 2021 GMT
 46 | //         Subject: O=Digital Signature Trust Co., CN=DST Root CA X3
 47 | //         Subject Public Key Info:
 48 | //             Public Key Algorithm: rsaEncryption
 49 | //                 Public-Key: (2048 bit)
 50 | //                 Modulus:
 51 | //                     00:df:af:e9:97:50:08:83:57:b4:cc:62:65:f6:90:
 52 | //                     82:ec:c7:d3:2c:6b:30:ca:5b:ec:d9:c3:7d:c7:40:
 53 | //                     c1:18:14:8b:e0:e8:33:76:49:2a:e3:3f:21:49:93:
 54 | //                     ac:4e:0e:af:3e:48:cb:65:ee:fc:d3:21:0f:65:d2:
 55 | //                     2a:d9:32:8f:8c:e5:f7:77:b0:12:7b:b5:95:c0:89:
 56 | //                     a3:a9:ba:ed:73:2e:7a:0c:06:32:83:a2:7e:8a:14:
 57 | //                     30:cd:11:a0:e1:2a:38:b9:79:0a:31:fd:50:bd:80:
 58 | //                     65:df:b7:51:63:83:c8:e2:88:61:ea:4b:61:81:ec:
 59 | //                     52:6b:b9:a2:e2:4b:1a:28:9f:48:a3:9e:0c:da:09:
 60 | //                     8e:3e:17:2e:1e:dd:20:df:5b:c6:2a:8a:ab:2e:bd:
 61 | //                     70:ad:c5:0b:1a:25:90:74:72:c5:7b:6a:ab:34:d6:
 62 | //                     30:89:ff:e5:68:13:7b:54:0b:c8:d6:ae:ec:5a:9c:
 63 | //                     92:1e:3d:64:b3:8c:c6:df:bf:c9:41:70:ec:16:72:
 64 | //                     d5:26:ec:38:55:39:43:d0:fc:fd:18:5c:40:f1:97:
 65 | //                     eb:d5:9a:9b:8d:1d:ba:da:25:b9:c6:d8:df:c1:15:
 66 | //                     02:3a:ab:da:6e:f1:3e:2e:f5:5c:08:9c:3c:d6:83:
 67 | //                     69:e4:10:9b:19:2a:b6:29:57:e3:e5:3d:9b:9f:f0:
 68 | //                     02:5d
 69 | //                 Exponent: 65537 (0x10001)
 70 | //         X509v3 extensions:
 71 | //             X509v3 Basic Constraints: critical
 72 | //                 CA:TRUE
 73 | //             X509v3 Key Usage: critical
 74 | //                 Certificate Sign, CRL Sign
 75 | //             X509v3 Subject Key Identifier: 
 76 | //                 C4:A7:B1:A4:7B:2C:71:FA:DB:E1:4B:90:75:FF:C4:15:60:85:89:10
 77 | //     Signature Algorithm: sha1WithRSAEncryption
 78 | //          a3:1a:2c:9b:17:00:5c:a9:1e:ee:28:66:37:3a:bf:83:c7:3f:
 79 | //          4b:c3:09:a0:95:20:5d:e3:d9:59:44:d2:3e:0d:3e:bd:8a:4b:
 80 | //          a0:74:1f:ce:10:82:9c:74:1a:1d:7e:98:1a:dd:cb:13:4b:b3:
 81 | //          20:44:e4:91:e9:cc:fc:7d:a5:db:6a:e5:fe:e6:fd:e0:4e:dd:
 82 | //          b7:00:3a:b5:70:49:af:f2:e5:eb:02:f1:d1:02:8b:19:cb:94:
 83 | //          3a:5e:48:c4:18:1e:58:19:5f:1e:02:5a:f0:0c:f1:b1:ad:a9:
 84 | //          dc:59:86:8b:6e:e9:91:f5:86:ca:fa:b9:66:33:aa:59:5b:ce:
 85 | //          e2:a7:16:73:47:cb:2b:cc:99:b0:37:48:cf:e3:56:4b:f5:cf:
 86 | //          0f:0c:72:32:87:c6:f0:44:bb:53:72:6d:43:f5:26:48:9a:52:
 87 | //          67:b7:58:ab:fe:67:76:71:78:db:0d:a2:56:14:13:39:24:31:
 88 | //          85:a2:a8:02:5a:30:47:e1:dd:50:07:bc:02:09:90:00:eb:64:
 89 | //          63:60:9b:16:bc:88:c9:12:e6:d2:7d:91:8b:f9:3d:32:8d:65:
 90 | //          b4:e9:7c:b1:57:76:ea:c5:b6:28:39:bf:15:65:1c:c8:f6:77:
 91 | //          96:6a:0a:8d:77:0b:d8:91:0b:04:8e:07:db:29:b6:0a:ee:9d:
 92 | //          82:35:35:10
 93 |         "-----BEGIN CERTIFICATE-----\n" .
 94 |         "MIIDSjCCAjKgAwIBAgIQRK+wgNajJ7qJMDmGLvhAazANBgkqhkiG9w0BAQUFADA/\n" .
 95 |         "MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT\n" .
 96 |         "DkRTVCBSb290IENBIFgzMB4XDTAwMDkzMDIxMTIxOVoXDTIxMDkzMDE0MDExNVow\n" .
 97 |         "PzEkMCIGA1UEChMbRGlnaXRhbCBTaWduYXR1cmUgVHJ1c3QgQ28uMRcwFQYDVQQD\n" .
 98 |         "Ew5EU1QgUm9vdCBDQSBYMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB\n" .
 99 |         "AN+v6ZdQCINXtMxiZfaQguzH0yxrMMpb7NnDfcdAwRgUi+DoM3ZJKuM/IUmTrE4O\n" .
100 |         "rz5Iy2Xu/NMhD2XSKtkyj4zl93ewEnu1lcCJo6m67XMuegwGMoOifooUMM0RoOEq\n" .
101 |         "OLl5CjH9UL2AZd+3UWODyOKIYepLYYHsUmu5ouJLGiifSKOeDNoJjj4XLh7dIN9b\n" .
102 |         "xiqKqy69cK3FCxolkHRyxXtqqzTWMIn/5WgTe1QLyNau7Fqckh49ZLOMxt+/yUFw\n" .
103 |         "7BZy1SbsOFU5Q9D8/RhcQPGX69Wam40dutolucbY38EVAjqr2m7xPi71XAicPNaD\n" .
104 |         "aeQQmxkqtilX4+U9m5/wAl0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV\n" .
105 |         "HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFMSnsaR7LHH62+FLkHX/xBVghYkQMA0GCSqG\n" .
106 |         "SIb3DQEBBQUAA4IBAQCjGiybFwBcqR7uKGY3Or+Dxz9LwwmglSBd49lZRNI+DT69\n" .
107 |         "ikugdB/OEIKcdBodfpga3csTS7MgROSR6cz8faXbauX+5v3gTt23ADq1cEmv8uXr\n" .
108 |         "AvHRAosZy5Q6XkjEGB5YGV8eAlrwDPGxrancWYaLbumR9YbK+rlmM6pZW87ipxZz\n" .
109 |         "R8srzJmwN0jP41ZL9c8PDHIyh8bwRLtTcm1D9SZImlJnt1ir/md2cXjbDaJWFBM5\n" .
110 |         "JDGFoqgCWjBH4d1QB7wCCZAA62RjYJsWvIjJEubSfZGL+T0yjWW06XyxV3bqxbYo\n" .
111 |         "Ob8VZRzI9neWagqNdwvYkQsEjgfbKbYK7p2CNTUQ\n" .
112 |         "-----END CERTIFICATE-----"
113 | ); // end            
114 | 
115 |     /**
116 |      * @var string User agent used for API requests
117 |      */
118 |     public static $USER_AGENT = 'php_figo';
119 |     /**
120 |      * @var string Version of this SDK, used in user agent for API requests
121 |      */
122 |     public static $SDK_VERSION = '3.0.1';
123 | }
124 | 
125 | ?>
126 | 


--------------------------------------------------------------------------------
/figo/Connection.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | require_once("utils.php");
 27 | 
 28 | use Psr\Log\LoggerInterface;
 29 | use Psr\Log\NullLogger;
 30 | 
 31 | /**
 32 |  * Represents a non user-bound connection to the figo Connect API
 33 |  */
 34 | class Connection {
 35 |     /**
 36 |      * @var LoggerInterface
 37 |      */
 38 |     protected $logger;
 39 |     private $client_id;
 40 |     private $client_secret;
 41 |     private $redirect_uri;
 42 |     /**
 43 |      * @var null API endpoint
 44 |      */
 45 |     private $apiEndpoint;
 46 | 
 47 |     /**
 48 |      * Constructor
 49 |      *
 50 |      * @param string the client ID
 51 |      * @param string the client secret
 52 |      * @param string redirect URI
 53 |      * @param string $apiEndpoint Custom API endpoint
 54 |      */
 55 |     public function __construct($client_id, $client_secret, $redirect_uri = null, $apiEndpoint = null) {
 56 |         // set default values
 57 |         $this->logger = new NullLogger();
 58 |         $this->apiEndpoint = Config::$API_ENDPOINT;
 59 |     
 60 |         $this->client_id = $client_id;
 61 |         $this->client_secret = $client_secret;
 62 |         $this->redirect_uri = $redirect_uri;
 63 | 
 64 |         if ($apiEndpoint) {
 65 |             $this->apiEndpoint = $apiEndpoint;
 66 |         }
 67 |         $this->apiUrl = parse_api_endpoint($this->apiEndpoint);
 68 | 
 69 |     }
 70 | 
 71 |     /**
 72 |      * Set Logger
 73 |      *
 74 |      * @param LoggerInterface $logger
 75 |      */
 76 |     public function setLogger(LoggerInterface $logger)
 77 |     {
 78 |         $this->logger = $logger;
 79 |     }
 80 | 
 81 |     /**
 82 |      * Helper method for making a OAuth 2.0 request
 83 |      *
 84 |      * @param string the URL path on the server
 85 |      * @param array this optional associative array will be used as url-encoded POST content.
 86 |      * @param string $method GET or POST Requests
 87 |      * @param string $encode http_build_query or json_encode
 88 |      *
 89 |      * @return array JSON response
 90 |      */
 91 |     public function query_api($path, array $data = null, $method='POST', $encode='http_build_query', $language = 'de') {
 92 |         if ($encode != 'http_build_query') {
 93 |             $data = is_null($data) ? "" : json_encode($data);
 94 |             $content_type = "application/json";
 95 |         } else {
 96 |             $data = is_null($data) ? "" : http_build_query($data);
 97 |             $content_type = "application/x-www-form-urlencoded";
 98 |         }
 99 | 
100 |         $headers = array("Authorization"  => "Basic ".base64_encode($this->client_id.":".$this->client_secret),
101 |                         "Content-Type"   => $content_type,
102 |                          "Content-Length" => strlen($data));
103 | 
104 |         $request = new HttpsRequest($this->apiUrl['host'], $this->logger);
105 |         $path = $this->apiUrl['path'] . $path;
106 |         return $request->request($path, $data, $method, $headers, $language);
107 |     }
108 | 
109 |     /**
110 |      * Get the URL a user should open in the web browser to start the login process
111 |      *
112 |      * When the process is completed, the user is redirected to the URL provided to
113 |      * the constructor and passes on an authentication code. This code can be converted
114 |      * into an access token for data access.
115 |      *
116 |      * @param string this string will be passed on through the complete login
117 |      *        process and to the redirect target at the end. It should be used to
118 |      *        validated the authenticity of the call to the redirect URL
119 |      * @param string scope of data access to ask the user for, e.g. <code>accounts=ro</code>
120 |      * @return string the URL to be opened by the user
121 |      */
122 |     public function login_url($state, $scope = null) {
123 |         $data = array("response_type" => "code",
124 |                       "client_id"     => $this->client_id,
125 |                       "state"         => $state);
126 |         if (!is_null($this->redirect_uri)) {
127 |             $data["redirect_uri"] = $this->redirect_uri;
128 |         }
129 |         if (!is_null($scope)) {
130 |             $data["scope"] = $scope;
131 |         }
132 |         return $this->apiEndpoint."/auth/code?".http_build_query($data);
133 |     }
134 | 
135 | 
136 | 
137 |     /**
138 |      * Retrieve list of supported banks, credit cards, other payment services
139 |      *
140 |      * @param String $service      filter the type of service to request (optional): `banks`, `services` or everything (default)
141 |      * @param String $country_code the country code the service comes from
142 |      *
143 |      * @return array
144 |      */
145 |     public function get_supported_payment_services($service=null, $countryCode = null, $language = 'de') {
146 |         switch ($service) {
147 |             case "banks":
148 | 
149 |                 $url = '/catalog/banks';
150 | 
151 |                 if($countryCode) {
152 |                     $url = $url . '/' . $countryCode;
153 |                 }
154 | 
155 |                 $response = $this->query_api($url, null, "GET", "http_build_query", $language);
156 |                 break;
157 |             case "services":
158 |                 $response = $this->query_api("/catalog/services", null, "GET", "http_build_query", $language);
159 |                 break;
160 |             default:
161 |                 $response = $this->query_api("/catalog", null, "GET", "http_build_query", $language);
162 |         }
163 |         return $response;
164 |     }
165 | 
166 |     /**
167 |      * Exchange authorization code or refresh token for access token.
168 |      *
169 |      * @param string either the authorization code received as part of the call to the
170 |      *        redirect URL at the end of the logon process, or a refresh token
171 |      * @param string scope of data access to ask the user for, e.g. <code>accounts=ro</code>
172 |      * @return array associative array with the keys <code>access_token</code>, <code>refresh_token</code>
173 |      *         and <code>expires</code>, as documented in the figo Connect API specification
174 |      */
175 |     public function obtain_access_token($authorization_code_or_refresh_token, $scope = null) {
176 |         // Authorization codes always start with "O" and refresh tokens always start with "R".
177 |         if ($authorization_code_or_refresh_token[0] === "O") {
178 |             $data = array("grant_type" => "authorization_code", "code" => $authorization_code_or_refresh_token);
179 |             if (!is_null($this->redirect_uri)) {
180 |                 $data["redirect_uri"] = $this->redirect_uri;
181 |             }
182 |         } elseif ($authorization_code_or_refresh_token[0] === "R") {
183 |             $data = array("grant_type" => "refresh_token", "refresh_token" => $authorization_code_or_refresh_token);
184 |             if (!is_null($scope)) {
185 |                 $data["scope"] = $scope;
186 |             }
187 |         } else {
188 |             throw new Exception("invalid_token", "invalid code/token");
189 |         }
190 |         return $this->query_api("/auth/token", $data, "POST", "json_encode");
191 |     }
192 | 
193 |     /**
194 |      * Native client login with figo Account credentials.
195 |      *
196 |      * @param string the figo Account email address
197 |      * @param string the figo Account password
198 |      * @param string scope of data access to ask the user for, e.g. <code>accounts=ro</code>
199 |      * @return array associative array with the keys <code>access_token</code>, <code>refresh_token</code>
200 |      *         and <code>expires</code>, as documented in the figo Connect API specification
201 |      */
202 |     public function native_client_login($username, $password, $scope = null) {
203 |         $data = array("grant_type" => "password", "username" => $username, "password" => $password, "scope" => $scope);
204 |         return $this->query_api("/auth/token", $data, "POST", "json_encode");
205 |     }
206 | 
207 | 
208 |     /**
209 |      * Revoke refresh token or access token.
210 |      *
211 |      * This action has immediate effect, i.e. you will not be able use that token anymore after this call.
212 |      *
213 |      * @param string access or refresh token to be revoked
214 |      */
215 |     public function revoke_token($refresh_token_or_access_token) {
216 |         $data = array("token" => $refresh_token_or_access_token);
217 |         $this->query_api("/auth/revoke", $data, "POST", "json_encode");
218 |     }
219 | 
220 |     /**
221 |      * Create a Process
222 |      * Example Usage:
223 |      *   $process = new \figo\Process();
224 |          $process->email = 'my_email@example.com';
225 |          $process->password = 'my_password';
226 |          $process->state = 'First_step';
227 |          $process->steps =   array(
228 |             array(
229 |                 'options' => json_decode('{}'),
230 |                 'type' => 'figo.steps.account.create',
231 |             ),
232 |             array(
233 |                 'options' => array(
234 |                 'account_number' => '100100100',
235 |                 'amount' =>  99,
236 |                 'bank_code' => "82051000",
237 |                 'currency' => "EUR",
238 |                 'name' => "Figo GmbH",
239 |                 'purpose' => "Yearly contribution",
240 |                 'type' => "Transfer",
241 |             ),
242 |             'type' => 'figo.steps.payment.submit',
243 |             )
244 |       );
245 |         $return = $connection->create_process($process);
246 |      *
247 |      *
248 |      * @param Process $process Figo Process
249 |      *
250 |      * @return array
251 |      */
252 |     public function create_process(Process $process) {
253 |         return $this->query_api("/client/process", $process->dump(), "POST", "json_encode");
254 |     }
255 | 
256 | 
257 |     /**
258 |      * Create a new figo Account
259 |      *
260 |      * @param string First and last name
261 |      * @param string Email address; It must obey the figo username & password policy
262 |      * @param string New figo Account password; It must obey the figo username & password policy
263 |      * @param string Two-letter code of preferred language
264 |      * @param boolean This flag indicates whether the user has agreed to be contacted by email
265 |      * @return string Auto-generated recovery password
266 |      */
267 |     public function create_user($name, $email, $password, $language='de') {
268 |         $data = array('name' => $name, 'email' => $email, 'password' => $password, 'language' => $language, 'affiliate_client_id' => $this->client_id);
269 |         $response = $this->query_api("/auth/user", $data, "POST", "json_encode");
270 |         return $response["recovery_password"];
271 |     }
272 | 
273 |     /**
274 |      * credential login
275 |      *
276 |      * @param $username
277 |      * @param $password
278 |      * @param null $device_name
279 |      * @param null $device_type
280 |      * @param null $device_udid
281 |      * @param null $scope
282 |      * @return array
283 |      */
284 |     public function credential_login($username, $password, $device_name = null, $device_type = null, $device_udid = null, $scope = null)
285 |     {
286 |         return $this->native_client_login($username, $password, $scope);
287 |     }
288 | 
289 | 
290 | }
291 | 
292 | ?>
293 | 


--------------------------------------------------------------------------------
/figo/Exception.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Base class for all errors transported via the figo Connect API
29 |  */
30 | class Exception extends \Exception {
31 | 
32 |     /** @var string the error code */
33 |     public $error;
34 | 
35 |     /** @var string the error description */
36 |     public $error_description;
37 | 
38 |     /**
39 |      * Constructor
40 |      *
41 |      * @param string the error code
42 |      * @param string the error description
43 |      */
44 |     public function __construct($error, $error_description) {
45 |         $this->error = $error;
46 |         $this->error_description = $error_description;
47 |         parent::__construct($error . ', ' . $error_description);
48 |     }
49 | 
50 |     /**
51 |      * Convert error object to string
52 |      *
53 |      * @return string the error description
54 |      */
55 |     public function __toString() {
56 |         return $this->error . ', ' . $this->error_description."\n";
57 |     }
58 | }
59 | 
60 | ?>
61 | 


--------------------------------------------------------------------------------
/figo/HttpsRequest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | use Psr\Log\LoggerInterface;
 27 | 
 28 | /**
 29 |  * HTTPS request class with certificate authentication and enhanced error handling
 30 |  */
 31 | class HttpsRequest {
 32 |     /**
 33 |      * @var LoggerInterface
 34 |      */
 35 |     protected $logger;
 36 |     /**
 37 |      * @var string
 38 |      */
 39 |     private $apiEndpoint;
 40 |  
 41 |     public function __construct($apiEndpoint, LoggerInterface $logger)
 42 |     {
 43 |         $this->logger = $logger;
 44 |         $this->apiEndpoint = $apiEndpoint;
 45 |     }
 46 | 
 47 |     /**
 48 |      * Send client request and return server response.
 49 |      *
 50 |      * @param string $path the URL path on the server
 51 |      * @param string $data the HTTP body
 52 |      * @param string $method the HTTP method
 53 |      * @param array $headers additional HTTP headers
 54 |      * @return array JSON response
 55 |      * @throws Exception
 56 |      */
 57 |     public function request($path, $data, $method, array $headers, $language = 'de') {
 58 |         // Open socket.
 59 |         $context = stream_context_create();
 60 |         stream_context_set_option($context, "ssl", "cafile", dirname(__FILE__).DIRECTORY_SEPARATOR."ca-bundle.crt");
 61 |         stream_context_set_option($context, "ssl", "verify_peer", true);
 62 |         stream_context_set_option($context, "ssl", "capture_peer_cert", true);
 63 | 
 64 |         $fp = stream_socket_client("tlsv1.2://". $this->apiEndpoint .":443", $errno, $errstr, 60, STREAM_CLIENT_CONNECT, $context);
 65 |         if (!$fp) {
 66 |             throw new Exception("socket_error", $errstr);
 67 |         }
 68 |         stream_set_timeout($fp, 60);
 69 | 
 70 |         // Setup common HTTP headers.
 71 |         $headers["Host"] = parse_url(Config::$API_ENDPOINT)['host'];
 72 |         $headers["Accept"] = "application/json";
 73 |         $headers["User-Agent"] = Config::$USER_AGENT . '/' . Config::$SDK_VERSION;
 74 |         $headers["Connection"] = "close";
 75 |         $headers["accept-language"] = $language;
 76 | 
 77 |         // Send client request.
 78 |         $header = "";
 79 |         foreach ($headers as $key => $value) {
 80 |             $header .= $key.": ".$value."\r\n";
 81 |         }
 82 |         fwrite($fp, $method." ".$path." HTTP/1.1\r\n".$header."\r\n".$data);
 83 | 
 84 |         // Read server response.
 85 |         $response = stream_get_contents($fp);
 86 |         fclose($fp);
 87 |         preg_match("/ (\d+)/", $response, $code);
 88 |         $code = intval($code[1]);
 89 |         $body = substr($response, strpos($response, "\r\n\r\n") + 4);
 90 |         
 91 |         $responseArray = json_decode($body, true);
 92 | 
 93 |         $loggingData = array(
 94 |             'path' => $path,
 95 |             'data' => $data,
 96 |             'method' => $method,
 97 |             'headers' => $headers,
 98 |             'response' => array(
 99 |                 'status' => $code,
100 |                 'body' => $responseArray
101 |             )
102 |         );
103 | 
104 | 
105 |         // Evaluate HTTP response.
106 |         if ($code >= 200 && $code < 300) {
107 |             if (strlen($body) === 0) {
108 |                 $this->logSuccessfulRequest($path, $responseArray, $loggingData);
109 |                 return array();
110 |             }
111 | 
112 |             if (is_null($responseArray)) {
113 |                 $this->logFailedRequest($path, $responseArray, $loggingData);
114 |                 throw new Exception("json_error", "Cannot decode JSON object.");
115 |             }
116 | 
117 |             $this->logSuccessfulRequest($path, $responseArray, $loggingData);
118 |             return $responseArray;
119 |         }
120 | 
121 |         if (is_null($responseArray)) {
122 |             $this->logFailedRequest($path, $responseArray, $loggingData);
123 |             throw new Exception("json_error", "Cannot decode JSON object.");
124 |         }
125 | 
126 |         if ($code === 404) {
127 |             $this->logFailedRequest($path, $responseArray, $loggingData);
128 |             return null;
129 |         }
130 | 
131 |         if ($code >= 400 && $code < 500) {
132 |             $this->logFailedRequest($path, $responseArray, $loggingData);
133 |             throw new Exception("Code: ".$responseArray["error"]["code"], $responseArray["error"]["description"]);
134 |         }
135 | 
136 |         if ($code === 503) {
137 |             $this->logFailedRequest($path, $responseArray, $loggingData);
138 |             throw new Exception("service_unavailable", "Exceeded rate limit.");
139 |         }
140 | 
141 |         $this->logFailedRequest($path, $responseArray, $loggingData);
142 |         throw new Exception("internal_server_error", "We are very sorry, but something went wrong.");
143 | 
144 |     }
145 | 
146 |     protected function logSuccessfulRequest($path, $response, $data)
147 |     {
148 |         if (strpos($path, '/task/progress') !== false) {
149 |             // when on /task/progress
150 |             $data = array_merge($data, array('task_id' => explode('/task/progress?id=', $path)[1]));
151 |             if($response['is_erroneous']) {
152 |                 $this->logger->info('API request to /task/progress', $data);
153 |             } else {
154 |                 $this->logger->debug('API request to /task/progress', $data);
155 |             }
156 | 
157 |         } else {
158 |             // when not on /task/progress
159 |             $this->logger->debug('API request', $data);
160 |         }
161 |     }
162 | 
163 |     protected function logFailedRequest($path, $response, $data)
164 |     {
165 |         if (strpos($path, '/task/progress') !== false) {
166 |             // when on /task/progress
167 |             $this->logger->info('API request to /task/progress failed', $data);
168 |         } else {
169 |             // when not on /task/progress
170 |             $this->logger->info('API request failed', $data);
171 |         }
172 |     }
173 | }
174 | 
175 | ?>
176 | 


--------------------------------------------------------------------------------
/figo/Notification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a configured notification, e.g. a webhook or email hook
29 |  */
30 | class Notification extends Base {
31 | 
32 |     protected $dump_attributes = array("observe_key", "notify_uri", "state");
33 | 
34 |     /** @var string Internal figo Connect notification ID from the notification registration response */
35 |     public $notification_id;
36 | 
37 |     /** @var string One of the notification keys specified in the figo Connect API specification */
38 |     public $observe_key;
39 | 
40 |     /** @var string Notification messages will be sent to this URL */
41 |     public $notify_uri;
42 | 
43 |     /** @var string State similiar to sync and logon process. It will passed as POST payload for webhooks */
44 |     public $state;
45 | }
46 | 
47 | ?>
48 | 


--------------------------------------------------------------------------------
/figo/Payment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a payment
29 |  */
30 | class Payment extends Base {
31 | 
32 |   protected $dump_attributes = array("type", "name", "account_number", "bank_code", "amount", "currency", "purpose", "iban");
33 | 
34 |     /** @var string Internal figo Connect payment ID */
35 |     public $payment_id;
36 | 
37 |     /** @var string Internal figo Connect account ID */
38 |     public $account_id;
39 | 
40 |     /** @var string Payment type */
41 |     public $type;
42 | 
43 |     /** @var string Name of creditor or debtor */
44 |     public $name;
45 | 
46 |     /** @var string Account number of creditor or debtor */
47 |     public $account_number;
48 | 
49 |     /** @var string Bank code of creditor or debtor */
50 |     public $bank_code;
51 | 
52 |     /** @var string Bank name of creditor or debtor */
53 |     public $bank_name;
54 | 
55 |     /** @var string Icon of creditor or debtor bank */
56 |     public $bank_icon;
57 | 
58 |     /** @var dictionary Icon of the creditor or debtor bank in other resolutions */
59 |     public $bank_additional_icons;
60 | 
61 |     /** @var string IBAN of creditor or debtor. Will overwrite bank_code and account_number if both are set */
62 |     public $iban;
63 | 
64 |     /** @var float Order amount */
65 |     public $amount;
66 | 
67 |     /** @var string Three-character currency code */
68 |     public $currency;
69 | 
70 |     /** @var string Purpose text */
71 |     public $purpose;
72 | 
73 |     /** @var DateTime Timestamp of submission to the bank server */
74 |     public $submission_timestamp;
75 | 
76 |     /** @var DateTime Internal creation timestamp on the figo Connect server */
77 |     public $creation_timestamp;
78 | 
79 |     /** @var DateTime Internal modification timestamp on the figo Connect server */
80 |     public $modification_timestamp;
81 | 
82 |     /** @var string Transaction ID. This field is only set if the payment has been matched to a transaction */
83 |     public $transaction_id;
84 | }
85 | 


--------------------------------------------------------------------------------
/figo/Process.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2016 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a payment
29 |  */
30 | class Process {
31 | 
32 |     protected $dump_attributes = array("email", "password", "redirect_uri", "state", "steps");
33 | 
34 |     /** @var string The email of the existing user to use as context or the new user to create beforehand */
35 |     public $email;
36 | 
37 |     /** @var string The password of the user existing or new user */
38 |     public $password;
39 | 
40 |     /** @var string The authorization code will be sent to this callback URL */
41 |     public $redirect_uri;
42 | 
43 |     /** @var string Any kind of string that will be forwarded in the callback response message */
44 |     public $state;
45 | 
46 |     /** @var string A list of steps definitions */
47 |     public $steps;
48 | 
49 |     public function dump() {
50 |         $result = array();
51 |         foreach ($this->dump_attributes as $attribute) {
52 |             if (!is_null($this->$attribute)) {
53 |                 $result[$attribute] = $this->$attribute;
54 |             }
55 | 
56 |         }
57 |         return $result;
58 |     }
59 | 
60 | }
61 | 
62 | 


--------------------------------------------------------------------------------
/figo/Security.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a payment
29 |  */
30 | class Security extends Base {
31 | 
32 |     protected $dump_attributes = array("name", "isin", "wkn", "currency", "quantity", "amount", "amount_original_currency", "exchange_rate", "price", "price_currency", "purchase_price", "purchase_price_currency", "visited");
33 | 
34 |     /** @var string Internal figo Connect security ID */
35 |     public $security_id;
36 | 
37 |     /** @var string Internal figo Connect account ID */
38 |     public $account_id;
39 | 
40 |     /** @var string Name of the security */
41 |     public $name;
42 | 
43 |     /** @var string International Securities Identification Number */
44 |     public $isin;
45 | 
46 |     /** @var string Wertpapierkennnummer (if available) */
47 |     public $wkn;
48 | 
49 |     /** @var string Three-character currency code when measured in currency (and not pieces) */
50 |     public $currency;
51 | 
52 |     /** @var string Number of pieces or value */
53 |     public $quantity;
54 | 
55 |     /** @var float Monetary value in account currency */
56 |     public $amount;
57 | 
58 |     /** @var float Monetary value in trading currency */
59 |     public $amount_original_currency;
60 | 
61 |     /** @var float Exchange rate between trading and account currency */
62 |     public $exchange_rate;
63 | 
64 |     /** @var float current price */
65 |     public $price;
66 | 
67 |     /** @var string Currency of current price */
68 |     public $price_currency;
69 | 
70 |     /** @var float Purchase price */
71 |     public $purchase_price;
72 | 
73 |     /** @var String Currency of purchase price */
74 |     public $purchase_price_currency;
75 | 
76 |     /** @var Boolean This flag indicates whether the security has already been marked as visited by the user */
77 |     public $visited;
78 | 
79 |     /** @var DateTime Trading Internal creation timestamp on the figo Connect server */
80 |     public $creation_timestamp;
81 | 
82 |     /** @var DateTime Internal modification timestamp on the figo Connect server */
83 |     public $modification_timestamp;
84 | }
85 | 
86 | ?>


--------------------------------------------------------------------------------
/figo/Session.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | require_once("utils.php");
 27 | 
 28 | use Psr\Log\LoggerInterface;
 29 | use Psr\Log\NullLogger;
 30 | 
 31 | /**
 32 |  * Represents a user-bound connection to the figo Connect API and allows access to the user's data
 33 |  */
 34 | class Session {
 35 |     /**
 36 |      * @var LoggerInterface
 37 |      */
 38 |     protected $logger;
 39 |     private $access_token;
 40 |     /**
 41 |      * @var null API endpoint
 42 |      */
 43 |     private $apiEndpoint;
 44 | 
 45 |     /**
 46 |      * Constructor
 47 |      *
 48 |      * @param string the access token
 49 |      * @param string $apiEndpoint Custom API endpoint
 50 |      */
 51 |     public function __construct($access_token, $apiEndpoint = null) {
 52 |         // set default values
 53 |         $this->logger = new NullLogger();
 54 |         $this->apiEndpoint = Config::$API_ENDPOINT;
 55 | 
 56 |         $this->access_token = $access_token;
 57 | 
 58 |         if ($apiEndpoint) {
 59 |             $this->apiEndpoint = $apiEndpoint;
 60 |         }
 61 |         $this->apiUrl = parse_api_endpoint($this->apiEndpoint);
 62 | 
 63 |     }
 64 | 
 65 |     /**
 66 |      * Set Logger
 67 |      *
 68 |      * @param LoggerInterface $logger
 69 |      */
 70 |     public function setLogger(LoggerInterface $logger)
 71 |     {
 72 |         $this->logger = $logger;
 73 |     }
 74 | 
 75 |     /**
 76 |      * Helper method for making a REST request
 77 |      *
 78 |      * @param string $path the URL path on the server
 79 |      * @param array $data this optional associative array will be used as JSON-encoded POST content.
 80 |      * @param string $method the HTTP method
 81 |      * @return array JSON response
 82 |      */
 83 |     public function query_api($path, array $data = null, $method = "GET") {
 84 |         $data = is_null($data) ? "" : json_encode($data);
 85 | 
 86 |         $headers = array("Authorization"  => "Bearer ".$this->access_token,
 87 |                          "Content-Type"   => "application/json",
 88 |                          "Content-Length" => strlen($data));
 89 | 
 90 |         $request = new HttpsRequest($this->apiUrl['host'], $this->logger);
 91 |         $path = $this->apiUrl['path'] . $path;
 92 |         return $request->request($path, $data, $method, $headers);
 93 |     }
 94 | 
 95 |     /**
 96 |      * Retrieve the current figo Account
 97 |      *
 98 |      * @return User 'User' object for the current figo Account
 99 |      */
100 |     public function get_user() {
101 |         $response = $this->query_api("/rest/user");
102 |         return (is_null($response) ? null : new User($this, $response));
103 |     }
104 | 
105 |     /**
106 |      * Modify the current figo Account
107 |      *
108 |      * @param User modified user object to be saved
109 |      * @return User 'User' object for the updated figo Account
110 |      */
111 |     public function modify_user($user) {
112 |         $response = $this->query_api("/rest/user", $user->dump(), "PUT");
113 |         return (is_null($response) ? null : new User($this, $response));
114 |     }
115 | 
116 | 
117 |     /**
118 |      * Re-send verification E-Mail
119 |      *
120 |      * @return array
121 |      */
122 |     public function resend_verification() {
123 |         return $this->query_api('/rest/user/resend_verification',null, 'POST');
124 |     }
125 | 
126 | 
127 |     /**
128 |      * Delete the current figo account
129 |      *
130 |      * NOTE: this has an immidiate effect and you will not be able to interact with the account afterward
131 |      */
132 |     public function remove_user() {
133 |         $this->query_api("/rest/user", null, "DELETE");
134 |     }
135 | 
136 | 
137 |     /**
138 |      * Poll the task progress
139 |      *
140 |      * @param String $task_token given Task Token
141 |      * @param array $options Optional Options:
142 |      *           - `pin` - Submit PIN. If this parameter is set, then the parameter save_pin must be set, too.
143 |      *           - `continue` - This flag signals to continue after an error condition or to skip a PIN or challenge-response entry
144 |      *           - `save_pin` - This flag indicates whether the user has chosen to save the PIN on the figo Connect server
145 |      *           - `response` - Submit response to challenge.
146 |      *
147 |      * @return array an array of <code>Account</code> objects, one for each account the user has
148 |      *         granted the app access
149 |      */
150 |     public function get_task_state($task_token, $options=array()) {
151 | 
152 |         $transfer_options = array(
153 |             'id' => $task_token,
154 |             'save_pin' => isset($options['save_pin']) ? $options['save_pin'] : 0,
155 |             'continue' => isset($options['continue']) ? $options['continue'] : 0,
156 |         );
157 | 
158 |         $response = $this->query_api("/task/progress?id=". $task_token, $transfer_options, 'POST');
159 | 
160 |         return $response;
161 |     }
162 | 
163 |     /**
164 |      * Cancel Task
165 |      * @param String $task_token given Task Token
166 |      *
167 |      * @return void
168 |      */
169 |     public function cancel_task($task_token) {
170 |         return $this->query_api("/task/cancel?id=" . $task_token, array('id' => $task_token), 'POST');
171 |     }
172 | 
173 | 
174 |     /**
175 |      * Set up a new bank account
176 |      *
177 |      * @param string Bank code or IBAN (which the bank code is extracted from)
178 |      * @param string List of login credential strings. They must be in the same order as in the credentials list from the login settings
179 |      * @param array $options Optional Options:
180 |      *           - `country` - Two-letter country code. Valid values: de
181 |      *           - `save_pin` - This flag indicates whether the user has chosen to save the PIN on the figo Connect server
182 |      *           - `disable_first_sync` - This flag indicates whether the initial sync of the transactions and balances of the newly created accounts should be omitted
183 |      *           - `sync_tasks` - List of additional information to be fetched from the bank. Possible values are: standingOrders
184 |      *           - `redirect_uri` - The user will be redirect to this URI after completing the account setup
185 |      */
186 |     public function setup_bank_account($bank_code_or_iban, $credentials, $options) {
187 |         if (is_numeric($bank_code_or_iban)) {
188 |             $options["bank_code"] = (string) $bank_code_or_iban;
189 |         } else {
190 |             $options["iban"] = $bank_code_or_iban;
191 |         }
192 |         $options["credentials"] = $credentials;
193 |         return $this->query_api("/rest/accounts", $options, "POST");
194 |     }
195 | 
196 |     /**
197 |      * Retrieve list of accounts
198 |      *
199 |      * @return array an array of <code>Account</code> objects, one for each account the user has
200 |      *         granted the app access
201 |      */
202 |     public function get_accounts() {
203 |         $response = $this->query_api("/rest/accounts");
204 |         $accounts = array();
205 |         foreach ($response["accounts"] as $account) {
206 |             array_push($accounts, new Account($this, $account));
207 |         }
208 |         return $accounts;
209 |     }
210 | 
211 |     /**
212 |      * Retrieve a specific account
213 |      *
214 |      * @param string account_id ID of the account to be retrieved
215 |      * @return Account account object
216 |      */
217 |     public function get_account($account_id) {
218 |         $response = $this->query_api("/rest/accounts/".$account_id);
219 |         return (is_null($response) ? null : new Account($this, $response));
220 |     }
221 | 
222 |     /**
223 |      * Add an account
224 |      *
225 |      * @param $country
226 |      * @param $credentials
227 |      * @param $bank_code
228 |      * @param $iban
229 |      * @param $save_pin
230 |      * @return Account|null
231 |      */
232 |     public function add_account($country, $credentials, $bank_code, $iban, $save_pin)
233 |     {
234 |         $data = array("country" => $country, "credentials" => $credentials);
235 |         if ($iban) {
236 |             $data["iban"] = $iban;
237 |         } else if ($bank_code) {
238 |             $data["bank_code"] = $bank_code;
239 |         }
240 |         $data["save_pin"] = (is_bool($save_pin)) ? $save_pin : false;
241 |         $response = $this->query_api("/rest/accounts", $data, "POST");
242 |         return (is_null($response) ? null : new Account($this, $response));
243 |     }
244 | 
245 |     /**
246 |      * Remove an account
247 |      *
248 |      * @param string Account to be removed or its ID
249 |      */
250 |     public function remove_account($account_or_id) {
251 |         if (is_string($account_or_id)) {
252 |             $this->query_api("/rest/accounts/".$account_or_id, null, "DELETE");
253 |         } else {
254 |             $this->query_api("/rest/accounts/".$account_or_id->account_id, null, "DELETE");
255 |         }
256 |     }
257 | 
258 |     /**
259 |      * Retrieve balance and account limits
260 |      *
261 |      * @param string ID of the account to be retrieved
262 |      * @return AccountBalance 'AccountBalance' object for the respective account
263 |      */
264 |     public function get_account_balance($account_id) {
265 |         $response = $this->query_api("/rest/accounts/".$account_id."/balance");
266 |         return (is_null($response) ? null : new AccountBalance($this, $response));
267 |     }
268 | 
269 |     /**
270 |      * Modify balance or account limits
271 |      *
272 |      * @param string ID of the account to be modified
273 |      * @param AccountBalance modified AccountBalance object to be saved
274 |      * @return AccountBalance 'AccountBalance' object for the updated account as returned by the server
275 |      */
276 |     public function modify_account_balance($account_id, $account_balance) {
277 |         $response = $this->query_api("/rest/accounts/".$account_id."/balance", $account_balance->dump(), "PUT");
278 |         return (is_null($response) ? null : new AccountBalance($this, $response));
279 |     }
280 | 
281 |     /**
282 |      * Retrieve list of transactions (for one account or all)
283 |      *
284 |      * @param string  $account_id      ID of the account of which the transactions should be retrieved or null for all accounts
285 |      * @param mixed   $since           this parameter can either be a transaction ID or a date
286 |      * @param integer $count           limit the number of returned transactions
287 |      * @param integer $offset          which offset into the result set should be used to determin the first transaction to return (useful in combination with count)
288 |      * @param boolean $include_pending this flag indicates whether pending transactions should be included in the
289 |      *        response; pending transactions are always included as a complete set, regardless of
290 |      *        the `since` parameter
291 |      * @param string $sort              Determine whether results will be sorted in ascending or descending order.
292 |      * @return array an array of <code>Transaction</code> objects, one for each transaction of the user
293 |      */
294 |     public function get_transactions($account_id = null, $since = null, $count = 1000, $offset = 0, $include_pending = false, $sort = 'desc', $cents=false) {
295 |         $data = array("count" => $count, "offset" => $offset, "include_pending" => $include_pending ? "1" : "0", "sort" => $sort);
296 |         if ($cents) {
297 |             $data["cents"] = true;
298 |         }
299 | 
300 |         if (!is_null($since))
301 |             $data["since"] = is_a($since, "\DateTime") ? $since->format("Y-m-d") : $since;
302 | 
303 |         if (is_null($account_id)) {
304 |             $response = $this->query_api("/rest/transactions?".http_build_query($data));
305 |         } else {
306 |             $response = $this->query_api("/rest/accounts/".$account_id."/transactions?".http_build_query($data));
307 |         }
308 | 
309 |         $result = array();
310 |         foreach ($response["transactions"] as $entry) {
311 |             array_push($result, new Transaction($this, $entry));
312 |         }
313 |         return $result;
314 |     }
315 | 
316 |     /**
317 |      * Retrieve a specific standing Order.
318 |      *
319 |      * @param String $standing_order_id Id of standing Order to retrieve
320 |      * @param boolean $cents whetever to show the balance in cents
321 |      *
322 |      * @return StandingOrder
323 |      */
324 |     public function get_standing_order($standing_order_id, $cents=false) {
325 |         $response = $this->query_api('/rest/standing_orders/'.$standing_order_id, array('cents' => $cents),'GET');
326 |         return (is_null($response) ? null : new StandingOrder($this, $response));
327 |     }
328 | 
329 | 
330 |     /**
331 |      * Get all standing orders.
332 |      *
333 |      * @param bool $cents
334 |      * @return array
335 |      */
336 |     public function get_standing_orders($cents = false) {
337 |         $response = $this->query_api("/rest/standing_orders", array('cents' => $cents), 'GET');
338 |         $result = array();
339 |         foreach ($response["standing_orders"] as $account) {
340 |             array_push($result, new StandingOrder($this, $account));
341 |         }
342 |         return $result;
343 |     }
344 | 
345 | 
346 | 
347 |     /**
348 |      * Modify transaction for a transaction_id, one account or all Accounts. Only visited param can be change.
349 |      *
350 |      * @param int $transaction_id
351 |      * @param int $account_id
352 |      * @param boolean $visited
353 |      *
354 |      * @return array
355 |      */
356 |     public function modify_transaction(Transaction $transaction) {
357 |         if ($transaction->transaction_id && $transaction->account_id) {
358 |             return $response = $this->query_api("/rest/accounts/".$transaction->account_id."/transactions/".$transaction->transaction_id, $transaction->dump(), "PUT");
359 |         } else {
360 |             throw new Exception("Not a valid Transaction Object: transaction_id or account_id is missing");
361 |         }
362 |         return $response;
363 |     }
364 | 
365 |     /**
366 |      * Modify transaction for a transaction_id, one account or all Accounts. Only visited param can be change.
367 |      *
368 |      * @param String $account_id Optional, can be null
369 |      * @param boolean $visited
370 |      *
371 |      * @return void
372 |      */
373 |     public function modify_transactions($account_id = null, $visited) {
374 |         $data = array('visited' => $visited);
375 |         if ($account_id) {
376 |             $response = $this->query_api("/rest/accounts/".$account_id."/transactions", $data, "PUT");
377 |         } else {
378 |             $response = $this->query_api("/rest/transactions", $data, "PUT");
379 |         }
380 |     }
381 | 
382 |     /**
383 |      * Retrieve a specific transaction
384 |      *
385 |      * @param string ID of the account on which the transaction occured
386 |      * @param string ID of the transaction to be retrieved
387 |      * @return Transaction a `Transaction` object representing the transaction to be retrieved
388 |      */
389 |     public function get_transaction($account_id, $transaction_id) {
390 |         $response = $this->query_api("/rest/accounts/".$account_id."/transactions/".$transaction_id);
391 |         return (is_null($response) ? null : new Transaction($this, $response));
392 |     }
393 | 
394 |     /**
395 |      * Remove a specific transaction
396 |      *
397 |      * @param string ID of the account on which the transaction occured
398 |      * @param string ID of the transaction to be removed
399 |      */
400 |     public function remove_transaction($account_id, $transaction_id) {
401 |         $this->query_api("/rest/accounts/".$account_id."/transactions/".$transaction_id, null, "DELETE");
402 |     }
403 | 
404 |     /**
405 |      * Retrieve a specific bank
406 |      *
407 |      * @param string ID of the bank to be retrieved
408 |      * @return Bank a 'Bank' object representing the bank to be retrieved
409 |      */
410 |     public function get_bank($bank_id) {
411 |         $response = $this->query_api("/rest/banks/".$bank_id);
412 |         return (is_null($response) ? null : new Bank($this, $response));
413 |     }
414 | 
415 |     /**
416 |      * Modify a bank
417 |      *
418 |      * @param Bank modified bank object to be saved
419 |      * @return Bank 'Bank' object for the updated bank
420 |      */
421 |     public function modify_bank($bank) {
422 |         $response = $this->query_api("/rest/banks/".$bank->bank_id, $bank->dump(), "PUT");
423 |         return (is_null($response) ? null : new Bank($this, $response));
424 |     }
425 | 
426 |     /**
427 |      * Remove the stored PIN for a bank (if there was one)
428 |      *
429 |      * @param string ID of the bank whose PIN should be removed or its ID
430 |      */
431 |     public function remove_bank_pin($bank_or_id) {
432 |         if (is_string($bank_or_id)) {
433 |             $response = $this->query_api("/rest/banks/".$bank_or_id."/remove_pin", null, "POST");
434 |         } else {
435 |             $response = $this->query_api("/rest/banks/".$bank_or_id->bank_id."/remove_pin", null, "POST");
436 |         }
437 |     }
438 | 
439 |     /**
440 |      * Request the URL a user should open in the web browser to start the synchronization process
441 |      *
442 |      * @param string the user will be redirected to this URL after the process completes
443 |      * @param string this string will be passed on through the complete synchronization process
444 |      *        and to the redirect target at the end. It should be used to validated the authenticity of
445 |      *        the call to the redirect URL
446 |      * @return string the URL to be opened by the user
447 |      */
448 |     public function get_sync_url($redirect_uri, $state) {
449 |         $data = array("redirect_uri" => $redirect_uri, "state" => $state);
450 |         $response = $this->query_api("/rest/sync", $data, "POST");
451 |         return $this->apiEndpoint."/task/start?id=".$response["task_token"];
452 |     }
453 | 
454 | 
455 | 
456 | 
457 |     /**
458 |      * Start a synchronization task and return its token id
459 |      *
460 |      * @param string the user will be redirected to this URL after the process completes
461 |      * @param string this string will be passed on through the complete synchronization process
462 |      *        and to the redirect target at the end. It should be used to validated the authenticity of
463 |      *        the call to the redirect URL
464 |      * @return string the token id of the taks
465 |      */
466 |     public function start_sync($redirect_uri, $state) {
467 |         $data = array("redirect_uri" => $redirect_uri, "state" => $state);
468 |         $response = $this->query_api("/rest/sync", $data, "POST");
469 |         return $response["task_token"];
470 |     }
471 | 
472 | 
473 | 
474 | 
475 |     /**
476 |      * Retrieve all notifications
477 |      *
478 |      * @return array an array of <code>Notification</code> objects, one for each registered notification
479 |      */
480 |     public function get_notifications() {
481 |         $response = $this->query_api("/rest/notifications");
482 |         $notifications = array();
483 |         foreach ($response["notifications"] as $notification) {
484 |             array_push($notifications, new Notification($this, $notification));
485 |         }
486 |         return $notifications;
487 |     }
488 | 
489 |     /**
490 |      * Retrieve a specific notification
491 |      *
492 |      * @param string account_id ID of the notification to be retrieved
493 |      * @return Notification notification object
494 |      */
495 |     public function get_notification($notification_id) {
496 |         $response = $this->query_api("/rest/notifications/".$notification_id);
497 |         return (is_null($response) ? null : new Notification($this, $response));
498 |     }
499 | 
500 |     /**
501 |      * Register a new notification.
502 |      *
503 |      * @param Notification new notification to be created. It should have no notification_id set
504 |      * @return Notification newly created <code>Notification</code> object
505 |      */
506 |     public function add_notification($notification) {
507 |         $response = $this->query_api("/rest/notifications", $notification->dump(), "POST");
508 |         return (is_null($response) ? null : new Notification($this, $response));
509 |     }
510 | 
511 |     /**
512 |      * Modify an existing notification.
513 |      *
514 |      * @param Notification modified notification object
515 |      * @return Notification 'Notification' object for the modified notification
516 |      */
517 |     public function modify_notification($notification) {
518 |         $response = $this->query_api("/rest/notifications/".$notification->notification_id, $notification->dump(), "PUT");
519 |         return (is_null($response) ? null : new Notification($this, $response));
520 |     }
521 | 
522 |     /**
523 |      * Unregister notification.
524 |      *
525 |      * @param Notification notification_or_id object which should be deleted or its ID
526 |      *
527 |      * @return void
528 |      */
529 |     public function remove_notification($notification_or_id) {
530 |         if(is_string($notification_or_id)) {
531 |             $this->query_api("/rest/notifications/".$notification_or_id, null, "DELETE");
532 |         } else {
533 |             $this->query_api("/rest/notifications/".$notification_or_id->notification_id, null, "DELETE");
534 |         }
535 |     }
536 | 
537 |     /**
538 |      * Retrieve all payments (of all or one account)
539 |      *
540 |      * @param string ID of the account of which to retrieve the payments
541 |      * @return array an array of <code>Payment</code> objects, one for each payment
542 |      */
543 |     public function get_payments($account_id = null) {
544 |         if (is_null($account_id)) {
545 |             $response = $this->query_api("/rest/payments");
546 |         } else {
547 |             $response = $this->query_api("/rest/accounts/".$account_id."/payments");
548 |         }
549 | 
550 |         $result = array();
551 |         foreach ($response["payments"] as $entry) {
552 |             array_push($result, new Payment($this, $entry));
553 |         }
554 |         return $result;
555 |     }
556 | 
557 |     /**
558 |      * Retrieve a specific payment
559 |      *
560 |      * @param string ID of the account on which the payment is to be found
561 |      * @param string ID of the payment to be retrieved
562 |      * @return Payment payment object
563 |      */
564 |     public function get_payment($account_id, $payment_id) {
565 |         $response = $this->query_api("/rest/accounts/".$account_id."/payments/".$payment_id);
566 |         return (is_null($response) ? null : new Payment($this, $response));
567 |     }
568 | 
569 |     /**
570 |      * Create a new payment
571 |      *
572 |      * @param Payment payment to be created. It should not have its payment_id set
573 |      * @return Payment newly created <code>Payment</code> object
574 |      */
575 |     public function add_payment($payment) {
576 |         $response = $this->query_api("/rest/accounts/".$payment->account_id."/payments", $payment->dump(), "POST");
577 |         return (is_null($response) ? null : new Payment($this, $response));
578 |     }
579 | 
580 |     /**
581 |      * Modify payment.
582 |      *
583 |      * @param Payment modified payment object to be saved
584 |      * @return Payment 'Payment' object for the updated payment
585 |      */
586 |     public function modify_payment($payment) {
587 |         $response = $this->query_api("/rest/accounts/".$payment->account_id."/payments/".$payment->payment_id, $payment->dump(), "PUT");
588 |         return (is_null($response) ? null : new Payment($this, $response));
589 |     }
590 | 
591 |     /**
592 |      * Delete payment.
593 |      *
594 |      * @param string ID of the account on which the payment can be found
595 |      * @param string ID of the payment to be deleted (or null when using a payment instance as first parameter)
596 |      *
597 |      * @return void
598 |      */
599 |     public function remove_payment($account_id_or_payment, $payment_id=null) {
600 |         if(is_string($account_id_or_payment)) {
601 |             if(is_string($payment_id)) {
602 |                 $this->query_api("/rest/accounts/".$account_id_or_payment."/payments/".$payment_id, null, "DELETE");
603 |             } else {
604 |                 throw new Exception('invalid_request', 'Missing payment_id parameter');
605 |             }
606 |         } else {
607 |             $this->query_api("/rest/accounts/".$account_id_or_payment->account_id."/payments/".$account_id_or_payment->payment_id, null, "DELETE");
608 |         }
609 |     }
610 | 
611 |     /**
612 |      * Retrieve securities of one or all accounts
613 |      *
614 |      * @param String $account_id  Id of the Account the security belongs to
615 |      * @param String $security_id Id of the security to retrieve
616 |      *
617 |      * return Figo\Security
618 |      */
619 |     public function get_security($account_id, $security_id) {
620 |         $response = $this->query_api("/rest/accounts/".$account_id."/securities/".$security_id);
621 |         return (is_null($response) ? null : new Security($this, $response));
622 |     }
623 | 
624 |     /**
625 |      * Retrieve securities of one or all accounts.
626 |      *
627 |      * @param Array $options further options (all are optional)
628 |     - **account_id** (`String`) - ID of the account for which to retrieve the securities
629 |     - **accounts** (`Array`) - filter the securities to be only from these accounts
630 |     - **since** (`Date`) - ISO date filtering the returned securities by their creation or last modification date
631 |     - **since_type** (`String`) - defines hot the `since` will be interpreted: `traded`, `created` or `modified`
632 |     - **count** (`Number`) - limit the number of returned transactions
633 |     - **offset** (`Number`) - offset into the implicit list of transactions
634 |      *
635 |      * @return array
636 |      */
637 |     public function get_securities($options) {
638 |         if (isset($options['account_id'])) {
639 |             $account_id = $options['account_id'];
640 |             unset($options['account_id']);
641 |             $response = $this->query_api("/rest/accounts/".$account_id."/securities", $options, 'GET');
642 |         } else {
643 |             $response = $this->query_api("/rest/securities", $options, 'GET');
644 |         }
645 |         $result = array();
646 |         foreach ($response["securities"] as $entry) {
647 |             array_push($result, new Security($this, $entry));
648 |         }
649 | 
650 |         return $result;
651 |     }
652 | 
653 |     /**
654 |      * Modify a Security.
655 |      *
656 |      * @param $account_id  ID of the account the security belongs to
657 |      * @param $security_id ID of the security to change
658 |      * @param $visited     a bit showing whether the user has already seen this security or not
659 |      *
660 |      * @return array
661 |      */
662 |     public function modify_security($account_id, $security_id, $visited) {
663 |         $response = $this->query_api("/rest/accounts/".$account_id."/securities/" . $security_id ,array('visited' => $visited), 'PUT');
664 |         return $response;
665 |     }
666 | 
667 | 
668 |     /**
669 |      * Modify securities of one or all accounts.
670 |      *
671 |      * @param $account_id optional Account Id
672 |      * @param $visited
673 |      *
674 |      * @return void
675 |      */
676 |     public function modify_securities($account_id=null, $visited) {
677 |         if ($account_id) {
678 |             $response = $this->query_api("/rest/accounts/".$account_id."/securities", array('visited' => $visited), 'PUT');
679 |         } else {
680 |             $response = $this->query_api("/rest/securities", array('visited' => $visited) , 'PUT');
681 |         }
682 |     }
683 | 
684 |     /**
685 |      * Submit payment to bank server
686 |      *
687 |      * @param Payment payment to be submitted
688 |      * @param string TAN scheme ID of user-selected TAN scheme
689 |      * @param string Any kind of string that will be forwarded in the callback response message
690 |      * @param string At the end of the submission process a response will be sent to this callback URL
691 |      * @return string the URL to be opened by the user for the TAN process
692 |      */
693 |     public function submit_payment($payment, $tan_scheme_id, $state, $redirect_uri=null) {
694 |         $data = array("tan_scheme_id" => $tan_scheme_id, "state" => $state);
695 |         if (!is_null($redirect_uri)) {
696 |             $data['redirect_uri'] = $redirect_uri;
697 |         }
698 | 
699 |         $response = $this->query_api("/rest/accounts/".$payment->account_id."/payments/".$payment->payment_id."/submit", $data, "POST");
700 |         if (is_null($response)) {
701 |             return  null;
702 |         } else {
703 |             return $this->apiEndpoint."/task/start?id=".$response["task_token"];
704 |         }
705 |     }
706 | }
707 | 
708 | ?>
709 | 


--------------------------------------------------------------------------------
/figo/StandingOrder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2016 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a payment
29 |  */
30 | class StandingOrder extends Base {
31 | 
32 |     protected $dump_attributes = array("type", "name", "account_number", "bank_code", "amount", "currency", "purpose");
33 | 
34 |     /** @var string Internal figo Connect standing ID */
35 |     public $standing_order_id;
36 | 
37 |     /** @var string Internal figo Connect account ID */
38 |     public $account_id;
39 | 
40 |     /** @var string First execution date of the standing order */
41 |     public $first_execution_date;
42 | 
43 |     /** @var string The day the standing order gets executed */
44 |     public $execuction_day;
45 | 
46 |     /** @var string The interval the standing order gets executed (possible values are weekly, monthly, two monthly, quarterly, half yearly and yearly) */
47 |     public $interval;
48 | 
49 |     /** @var string Name of recipient */
50 |     public $name;
51 | 
52 |     /** @var string Account number recipient */
53 |     public $account_number;
54 | 
55 |     /** @var string Bank code of recipient */
56 |     public $bank_code;
57 | 
58 |     /** @var string Bank name of recipient */
59 |     public $bank_name;
60 | 
61 |     /** @var float Standing order amount */
62 |     public $amount;
63 | 
64 |     /** @var string Three-character currency code */
65 |     public $currency;
66 | 
67 |     /** @var string Purpose text */
68 |     public $purpose;
69 | 
70 |     /** @var DateTime Internal creation timestamp on the figo Connect server */
71 |     public $creation_timestamp;
72 | 
73 |     /** @var DateTime Internal modification timestamp on the figo Connect server */
74 |     public $modification_timestamp;
75 | 
76 | }
77 | 


--------------------------------------------------------------------------------
/figo/SynchronizationStatus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing the bank server synchronization status
29 |  */
30 | class SynchronizationStatus extends Base {
31 | 
32 |     protected $dump_attributes = array();
33 | 
34 |     /** @var integer Internal figo Connect status code */
35 |     public $code;
36 | 
37 |     /** @var string Human-readable error message */
38 |     public $message;
39 | 
40 |     /** @var DateTime Timestamp of last synchronization */
41 |     public $sync_timestamp;
42 | 
43 |     /** @var DateTime Timestamp of last successful synchronization */
44 |     public $success_timestamp;
45 | }
46 | 
47 | ?>
48 | 


--------------------------------------------------------------------------------
/figo/Task.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing a payment
29 |  */
30 | class Task extends Base {
31 | 
32 |     protected $dump_attributes = array("account_id", "message", "is_waiting_for_pin", "is_waiting_for_response", "is_erroneous", "is_ended", "challenge");
33 | 
34 |     /** @var string Account ID of currently processed accoount */
35 |     public $account_id;
36 | 
37 |     /** @var string Status message or error message for currently processed amount */
38 |     public $message;
39 | 
40 |     /** @var string The figo Connect server is waiting for PIN */
41 |     public $is_waiting_for_pin;
42 | 
43 |     /** @var bool The figo Connect server is waiting for a response to the parameter challenge */
44 |     public $is_waiting_for_response;
45 | 
46 |     /** @var bool An error occured and the figo Connect server is waiting for continuation */
47 |     public $is_erroneous;
48 | 
49 |     /** @var bool The communication with a bank server has been completed */
50 |     public $is_ended;
51 | 
52 |     /** @var float Monetary value in account currency */
53 |     public $challenge;
54 | 
55 |     /** @var array Events */
56 |     public $events;
57 | 
58 |     /** @var array Schedule */
59 |     public $schedule;
60 | }
61 | 
62 | ?>
63 | 


--------------------------------------------------------------------------------
/figo/Transaction.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | namespace figo;
 25 | 
 26 | 
 27 | /**
 28 |  * Object representing one bank transaction on a certain bank account of the user
 29 |  */
 30 | class Transaction extends Base {
 31 | 
 32 |     protected $dump_attributes = array('visited');
 33 | 
 34 |     /** @var string Internal figo Connect transaction ID */
 35 |     public $transaction_id;
 36 | 
 37 |     /** @var string Internal figo Connect account ID */
 38 |     public $account_id;
 39 | 
 40 |     /** @var string Name of originator or recipient */
 41 |     public $name;
 42 | 
 43 |     /** @var string Account number of originator or recipient. */
 44 |     public $account_number;
 45 | 
 46 |     /** @var string Bank code of originator or recipient */
 47 |     public $bank_code;
 48 | 
 49 |     /** @var string Bank name of originator or recipient */
 50 |     public $bank_name;
 51 | 
 52 |     /** @var double Transaction amount */
 53 |     public $amount;
 54 | 
 55 |     /** @var string Three-character currency code */
 56 |     public $currency;
 57 | 
 58 |     /** @var DateTime Booking date */
 59 |     public $booking_date;
 60 | 
 61 |     /** @var DateTime Value date */
 62 |     public $value_date;
 63 | 
 64 |     /** @var string Purpose text */
 65 |     public $purpose;
 66 | 
 67 |     /** @var string Transaction type */
 68 |     public $type;
 69 | 
 70 |     /** @var string Booking text */
 71 |     public $booking_text;
 72 | 
 73 |     /** @var boolean This flag indicates whether the transaction is booked or pending */
 74 |     public $booked;
 75 | 
 76 |     /** @var DateTime Internal creation timestamp on the figo Connect server */
 77 |     public $creation_timestamp;
 78 | 
 79 |     /** @var DateTime Internal modification timestamp on the figo Connect server */
 80 |     public $modification_timestamp;
 81 | 
 82 |     /** @var boolean This flag indicates whether the transaction has already been marked as visited by the user */
 83 |     public $visited;
 84 | 
 85 |     /** @var array Contains additional information for PayPal transactions */
 86 |     public $additional_info;
 87 | 
 88 |     /** @var  Category[]*/
 89 |     public $categories;
 90 | 
 91 |     /** @var string BIC */
 92 |     public $bic;
 93 | 
 94 |     /** @var string IBAN */
 95 |     public $iban;
 96 | 
 97 |     /** @var string Booking key */
 98 |     public $booking_key;
 99 | 
100 |     /** @var string Creditor ID */
101 |     public $creditor_id;
102 | 
103 |     /** @var string Mandate reference */
104 |     public $mandate_reference;
105 | 
106 |     /** @var string SEPA purpose code */
107 |     public $sepa_purpose_code;
108 | 
109 |     /** @var string SEPA remittance info */
110 |     public $sepa_remittance_info;
111 | 
112 |     /** @var string Text key addition */
113 |     public $text_key_addition;
114 | 
115 |     /** @var string End to end reference */
116 |     public $end_to_end_reference;
117 | 
118 |     /** @var string Customer reference */
119 |     public $customer_reference;
120 | 
121 |     /** @var int Prima nota number */
122 |     public $prima_nota_number;
123 | }
124 | 
125 | ?>
126 | 


--------------------------------------------------------------------------------
/figo/User.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 |  * Copyright (c) 2013 figo GmbH
 4 |  *
 5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |  * of this software and associated documentation files (the "Software"), to deal
 7 |  * in the Software without restriction, including without limitation the rights
 8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |  * copies of the Software, and to permit persons to whom the Software is
10 |  * furnished to do so, subject to the following conditions:
11 |  *
12 |  * The above copyright notice and this permission notice shall be included in
13 |  * all copies or substantial portions of the Software.
14 |  *
15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 |  * THE SOFTWARE.
22 |  */
23 | 
24 | namespace figo;
25 | 
26 | 
27 | /**
28 |  * Object representing an user
29 |  */
30 | class User extends Base {
31 |     
32 |     protected $dump_attributes = array("name", "address", "send_newsletter", "language");
33 | 
34 |     /** @var string Internal figo Connect user ID */
35 |     public $user_id;
36 | 
37 |     /** @var string First and last name */
38 |     public $name;
39 | 
40 |     /** @var string Email address */
41 |     public $email;
42 | 
43 |     /** @var array Postal address for bills, etc. */
44 |     public $address;
45 | 
46 |     /** @var boolean This flag indicates whether the email address has been verified */
47 |     public $verified_email;
48 | 
49 |     /** @var boolean This flag indicates whether the user has agreed to be contacted by email */
50 |     public $send_newsletter;
51 | 
52 |     /** @var string Two-letter code of preferred language */
53 |     public $language;
54 | 
55 |     /** @var boolean This flag indicates whether the figo Account plan is free or premium */
56 |     public $premium;
57 | 
58 |     /** @var DateTime Timestamp of premium figo Account expiry */
59 |     public $premium_expires_on;
60 | 
61 |     /** @var string Provider for premium subscription or Null of no subscription is active */
62 |     public $premium_subscription;
63 | 
64 |     /** @var DateTime Timestamp of figo Account registration */
65 |     public $join_date;
66 | }
67 | 


--------------------------------------------------------------------------------
/figo/ca-bundle.crt:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/figo-connect/php-figo/5b3624412399b6463dccc1710002d0ca98cd620d/figo/ca-bundle.crt


--------------------------------------------------------------------------------
/figo/utils.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | function parse_api_endpoint($api_endpoint)   {
 4 |     $api_endpoint = rtrim($api_endpoint, "/");
 5 |     if (substr($api_endpoint, 0, 8) != "https://")    {
 6 |         $api_endpoint = "https://" . $api_endpoint;
 7 |     }
 8 |     $api_url = parse_url($api_endpoint);
 9 |     if (array_key_exists("path", $api_url) == false)    {
10 |         $api_url["path"] = "";
11 |     }
12 |     return $api_url;
13 | }
14 | 


--------------------------------------------------------------------------------
/phpunit.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0"?>
2 | <phpunit bootstrap="vendor/autoload.php">
3 |   <testsuites>
4 |     <testsuite>
5 |       <directory>test</directory>
6 |     </testsuite>
7 |   </testsuites>
8 | </phpunit>
9 | 


--------------------------------------------------------------------------------
/test/FigoTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 |  * Copyright (c) 2013 figo GmbH
  4 |  *
  5 |  * Permission is hereby granted, free of charge, to any person obtaining a copy
  6 |  * of this software and associated documentation files (the "Software"), to deal
  7 |  * in the Software without restriction, including without limitation the rights
  8 |  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  9 |  * copies of the Software, and to permit persons to whom the Software is
 10 |  * furnished to do so, subject to the following conditions:
 11 |  *
 12 |  * The above copyright notice and this permission notice shall be included in
 13 |  * all copies or substantial portions of the Software.
 14 |  *
 15 |  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 16 |  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 17 |  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 18 |  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 19 |  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 20 |  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 21 |  * THE SOFTWARE.
 22 |  */
 23 | 
 24 | use figo\Session;
 25 | use figo\Connection;
 26 | use figo\Notification;
 27 | use figo\Payment;
 28 | 
 29 | 
 30 | class SessionTest extends PHPUnit_Framework_TestCase {
 31 | 
 32 |     protected static $api_endpoint;
 33 |     protected static $connection;
 34 |     protected static $email;
 35 |     protected static $password;
 36 |     protected static $session;
 37 | 
 38 |     protected $access_token;
 39 |     protected $account_id;
 40 | 
 41 |     public static function setUpBeforeClass()   {
 42 |         $api_endpoint = getenv("FIGO_API_ENDPOINT");
 43 |         self::$connection = new Connection(getenv("FIGO_CLIENT_ID"), getenv("FIGO_CLIENT_SECRET"),
 44 |             "http://example.com/callback.php", $api_endpoint);
 45 |         $name = "PHP SDK Test";
 46 |         self::$email = "php.sdk.".rand()."@figo.io";
 47 |         self::$password = "sdk_test_pass_".rand();
 48 |         self::$connection->create_user($name, self::$email, self::$password);
 49 |         $response = self::$connection->native_client_login(self::$email, self::$password);
 50 |         $access_token = $response["access_token"];
 51 |         self::$session = new Session($access_token, $api_endpoint);
 52 |     }
 53 | 
 54 |     public static function tearDownAfterClass() {
 55 |         self::$session->remove_user();
 56 |     }
 57 | 
 58 |     public function test_credential_login() {
 59 | 
 60 |         $accounts = $this::$session->get_accounts();
 61 |         $this->assertEquals([], $accounts);
 62 |     }
 63 | 
 64 |     public function test_setup_account()    {
 65 |         $response = $this::$session->setup_bank_account("90090042", array("figo", "figo"), array());
 66 |         for($i = 0; $i <= 20; $i++)   {
 67 |             $task_state = $this::$session->get_task_state($response['task_token']);
 68 |             if($task_state['is_ended'] == true) {
 69 |                 break;
 70 |             }
 71 |             $this->assertFalse($task_state['is_erroneous']);
 72 |             sleep(1);
 73 |         }
 74 |     }
 75 | 
 76 |     public function test_get_accounts()   {
 77 |         $accounts = $this::$session->get_accounts();
 78 |         $this->assertEquals(3, count($accounts));
 79 |         $this->account_id = $accounts[0]->account_id;
 80 |         $single_account = $this::$session->get_account($this->account_id);
 81 |         $this->assertEquals($this->account_id, $single_account->account_id);
 82 |         $this->assertNotNull($single_account->balance->balance);
 83 |         $this->assertNotNull($single_account->balance->balance_date);
 84 |     }
 85 | 
 86 |     public function test_list_transactions()
 87 |     {
 88 |         $accounts = $this::$session->get_accounts();
 89 |         $this->account_id = $accounts[0]->account_id;
 90 |         $transactions = $this::$session->get_transactions();
 91 |         $this->assertGreaterThan(0, $transactions);
 92 |         $transactions = $this::$session->get_transactions($this->account_id);
 93 |         $this->assertGreaterThan(0, $transactions);
 94 |     }
 95 | 
 96 |     public function test_list_all_standing_orders() {
 97 |         $standing_orders = $this::$session->get_standing_orders();
 98 |         $this->assertEquals(0, count($standing_orders));
 99 |     }
100 | 
101 |     public function test_list_securities()  {
102 |         $options = array();
103 |         $securities = $this::$session->get_securities($options);
104 |         $this->assertGreaterThan(0, $securities);
105 |         $this->account_id = $securities[0]->account_id;
106 |         $options["account_id"] = $this->account_id;
107 |         $securities = $this::$session->get_securities($options);
108 |         $this->assertGreaterThan(0, $securities);
109 |     }
110 | 
111 |     public function test_list_all_payments()    {
112 |         $payments = $this::$session->get_payments();
113 |         $this->assertEquals(0, count($payments));
114 |     }
115 | 
116 |     public function test_list_account_payments()    {
117 |         $accounts = $this::$session->get_accounts();
118 |         $this->account_id = $accounts[0]->account_id;
119 |         $payments = $this::$session->get_payments($this->account_id);
120 |         $this->assertEquals(0, count($payments));
121 |     }
122 | 
123 |     public function test_list_all_notification_subscriptions()  {
124 |         $notifications = $this::$session->get_notifications();
125 |         $this->assertEquals(0, count($notifications));
126 |     }
127 | 
128 |     public function test_list_user_information()    {
129 |         $user = $this::$session->get_user();
130 |         $this->assertEquals($this::$email, $user->email);
131 |     }
132 | 
133 |     public function test_missing_handling() {
134 |         $this->assertNull($this::$session->get_account("WRONG"));
135 |     }
136 | 
137 |     public function test_error_handling() {
138 |          $this->setExpectedException('Exception');
139 |          $this::$session->get_sync_url("random", "");
140 |     }
141 | 
142 |     public function test_sync_url() {
143 |         $sync_url = $this::$session->get_sync_url("http://example.com/callback.php", "qew");
144 |         $this->assertGreaterThan(0, strlen($sync_url));
145 |     }
146 | 
147 |     public function test_create_update_delete_notification() {
148 |         $notification = $this::$session->add_notification(new Notification($this::$session, array("observe_key" => "/rest/transactions", "notify_uri" => "http://figo.me/test", "state" => "qwe")));
149 |         $this->assertEquals($notification->observe_key, "/rest/transactions");
150 |         $this->assertEquals($notification->notify_uri, "http://figo.me/test");
151 |         $this->assertEquals($notification->state, "qwe");
152 | 
153 |         $notification->state = "asd";
154 |         $this::$session->modify_notification($notification);
155 | 
156 |         $notification = $this::$session->get_notification($notification->notification_id);
157 |         $this->assertEquals($notification->observe_key, "/rest/transactions");
158 |         $this->assertEquals($notification->notify_uri, "http://figo.me/test");
159 |         $this->assertEquals($notification->state, "asd");
160 | 
161 |         $this::$session->remove_notification($notification);
162 |         $notification = $this::$session->get_notification($notification->notification_id);
163 |         $this->assertNull($notification);
164 |     }
165 | 
166 |     public function test_create_update_delete_payment() {
167 |         $accounts = $this::$session->get_accounts();
168 |         $this->account_id = $accounts[0]->account_id;
169 |         $added_payment = $this::$session->add_payment(new Payment($this::$session, array("account_id" => $this->account_id, "type" => "Transfer", "account_number" => "4711951501", "bank_code" => "90090042", "name" => "figo", "purpose" => "Thanks for all the fish.", "amount" => 0.89)));
170 |         $this->assertEquals($added_payment->account_id, $this->account_id);
171 |         $this->assertEquals($added_payment->bank_name, "Demobank");
172 |         $this->assertEquals($added_payment->amount, 0.89);
173 | 
174 |         $added_payment->amount = 2.39;
175 |         $modified_payment = $this::$session->modify_payment($added_payment);
176 |         $this->assertEquals($modified_payment->payment_id, $added_payment->payment_id);
177 |         $this->assertEquals($modified_payment->account_id, $this->account_id);
178 |         $this->assertEquals($modified_payment->bank_name, "Demobank");
179 |         $this->assertEquals($modified_payment->amount, 2.39);
180 | 
181 |         $this::$session->remove_payment($modified_payment);
182 |         $retrieved_payment = $this::$session->get_payment($modified_payment->account_id, $modified_payment->payment_id);
183 |         $this->assertNull($retrieved_payment);
184 |     }
185 | 
186 |     public function test_get_catalog_in_english()   {
187 |         $response = $this::$connection->get_supported_payment_services(null, null, "en");
188 |         $this->assertEquals("en", $response["banks"][0]["language"]["current_language"]);
189 |     }
190 | 
191 |     public function test_get_catalog_unsupported_language()
192 |     {
193 |         $this->setExpectedException(
194 |             \figo\Exception::class, 'Code: 1000, Unsupported language'
195 |         );
196 |         $this::$connection->get_supported_payment_services(null, null, 'fr');
197 |     }
198 | 
199 |     public function test_get_bank() 
200 |     {
201 |         $accounts = $this::$session->get_accounts();
202 |         $bank_id = $accounts[0]->bank_id;
203 |         $bank = $this::$session->get_bank($bank_id);
204 |         $this->assertNotNull($bank);
205 |     }
206 | }
207 | ?>
208 | 


--------------------------------------------------------------------------------
/web_demo/app.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | require_once __DIR__.'/../vendor/autoload.php';
 3 | require_once __DIR__.'/../figo/Connection.php';
 4 | require_once __DIR__.'/../figo/Session.php';
 5 | 
 6 | $app = new Silex\Application();
 7 | $app->register(new Silex\Provider\SessionServiceProvider());
 8 | $app->register(new Silex\Provider\TwigServiceProvider(), array('twig.path' => __DIR__.'/views'));
 9 | 
10 | $CLIENT_ID = "CaESKmC8MAhNpDe5rvmWnSkRE_7pkkVIIgMwclgzGcQY";
11 | $CLIENT_SECRET = "STdzfv0GXtEj_bwYn7AgCVszN1kKq5BdgEIKOM_fzybQ";
12 | $connection = new Figo\Connection($CLIENT_ID, $CLIENT_SECRET, "http://localhost:3000/callback");
13 | 
14 | $app->get('/', function() use($app, $connection) {
15 |     # check whether the user is logged in
16 |     if (!$app['session']->has('figo_token')) {
17 |         return $app->redirect($connection->login_url("qweqwe", "accounts=ro transactions=ro balance=ro user=ro"));
18 |     }
19 | 
20 |     $session = new Figo\Session($app['session']->get('figo_token'));
21 |     return $app['twig']->render('index.twig', array('transactions' => $session->get_transactions(),
22 |                                                     'accounts' => $session->get_accounts(),
23 |                                                     'current_account' => null,
24 |                                                     'user' => $session->get_user()));
25 | });
26 | 
27 | 
28 | $app->get('/callback', function() use($app, $connection) {
29 |     # authenticate the call
30 |     if($app['request']->query->get('state') != "qweqwe") {
31 |         throw new Exception("Bogus redirect, wrong state");
32 |     }
33 | 
34 |     # trade in authentication code for access token
35 |     $token_dict = $connection->obtain_access_token($app['request']->query->get("code"));
36 | 
37 |     # store the access token in our session
38 |     $app['session']->set('figo_token', $token_dict['access_token']);
39 | 
40 |     return $app->redirect("/");
41 | });
42 | 
43 | $app->get('/logout', function() use($app) {
44 |     $app['session']->remove('figo_token');
45 |     return $app->redirect('/');
46 | });
47 | 
48 | 
49 | $app->get('/{account_id}', function($account_id) use($app, $connection){
50 |     # check whether the user is logged in
51 |     if (!$app['session']->has('figo_token')) {
52 |         return $app->redirect($connection->login_url("qweqwe", "accounts=ro transactions=ro balance=ro user=ro"));
53 |     }
54 | 
55 |     $session = new Figo\Session($app['session']->get('figo_token'));
56 |     return $app['twig']->render('index.twig', array('transactions' => $session->get_transactions($account_id),
57 |                                                     'accounts' => $session->get_accounts(),
58 |                                                     'current_account' => $session->get_account($account_id),
59 |                                                     'user' => $session->get_user()));
60 | });
61 | 
62 | $app->run();
63 | 
64 | ?>
65 | 


--------------------------------------------------------------------------------
/web_demo/index.php:
--------------------------------------------------------------------------------
1 | <?php
2 | $filename = __DIR__.preg_replace('#(\?.*)$#', '', $_SERVER['REQUEST_URI']);
3 | if (php_sapi_name() === 'cli-server' && is_file($filename)) {
4 |     return false;
5 | }
6 | 
7 | $app = require __DIR__.'/app.php';
8 | ?>
9 | 


--------------------------------------------------------------------------------
/web_demo/static/banking.css:
--------------------------------------------------------------------------------
1 | body { padding-top: 70px; }
2 | 


--------------------------------------------------------------------------------
/web_demo/static/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/figo-connect/php-figo/5b3624412399b6463dccc1710002d0ca98cd620d/web_demo/static/favicon.ico


--------------------------------------------------------------------------------
/web_demo/views/index.twig:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | <head>
 4 |     <meta charset="utf-8">
 5 |     <meta http-equiv="X-UA-Compatible" content="IE=edge">
 6 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 7 |     <title>figo web banking</title>
 8 | 
 9 |     <!-- Bootstrap -->
10 |     <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css">
11 | 
12 |     <!-- HTML5 Shim and Respond.js IE8 support of HTML5 elements and media queries -->
13 |     <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
14 |     <!--[if lt IE 9]>
15 |       <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
16 |       <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
17 |     <![endif]-->
18 | 
19 |     <!-- figo design -->
20 |     <link href="/static/favicon.ico" rel="shortcut icon" />
21 |     <link href="/static/banking.css" rel="stylesheet" media="screen" />
22 | </head>
23 | <body>
24 |     <div class="navbar navbar-inverse navbar-fixed-top" role="navigation">
25 |         <div class="container-fluid">
26 |             <div class="navbar-header">
27 |                 <a class="navbar-brand" href="#">figo web banking</a>
28 |             </div>
29 |             <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
30 |                 <ul class="nav navbar-nav">
31 |                     <li {% if current_account == null %}class='active'{% endif %}><a href="/">Unified Inbox</a></li>
32 |                     {% for account in accounts %}
33 |                         <li {% if current_account.account_id == account.account_id %}class='active'{% endif %}><a href="/{{account.account_id}}">{{account.name}}</a></li>
34 |                     {% endfor %}
35 |                 </ul>
36 |                 <p class="navbar-text navbar-right">Signed in as <a href="/logout" class="navbar-link">{{user.email}}</a></p>
37 |             </div>
38 |         </div>
39 |     </div>
40 | 
41 |     <div class="container-fluid" role="main">
42 |         <h1>{% if current_account == null %}Unified Inbox{% else %}{{current_account.name}}{% endif %}</h1>
43 |         {% if current_account != null %}
44 |             <div class="panel panel-default">
45 |                 <div class="panel-heading">Account Details</div>
46 |                 <div class="panel-body">
47 |                     <ul class="list-group">
48 |                         <li class="list-group-item">Owner: {{current_account.owner}}</li>
49 |                         <li class="list-group-item">Account Number: {{current_account.account_number}}</li>
50 |                         <li class="list-group-item">Bank Code: {{current_account.bank_code}}</li>
51 |                         <li class="list-group-item">IBAN: {{current_account.iban}}</li>
52 |                         <li class="list-group-item">Balance: {{current_account.balance.balance}} {{current_account.currency}}</li>
53 |                     </ul>
54 |                 </div>
55 |             </div>
56 |         {% endif %}
57 | 
58 |         <table class="table table-hover table-condensed">
59 |             <thead>
60 |                 <tr>
61 |                     <th>Date</th>
62 |                     <th>Name</th>
63 |                     <th>Account Number</th>
64 |                     <th>Purpose</th>
65 |                     <th style="text-align: right;">Amount</th>
66 |                 </tr>
67 |             </thead>
68 |             <tbody>
69 |                 {% for transaction in transactions %}
70 |                     <tr>
71 |                         <td>{{transaction.value_date|date("d.m.Y")}}</td>
72 |                         <td>{{transaction.name}}</td>
73 |                         <td>{{transaction.account_number}}</td>
74 |                         <td>{{transaction.purpose}}</td>
75 |                         <td style="text-align: right; {% if transaction.amount < 0 %}color: red;{% endif %}">{{transaction.amount}}</td>
76 |                     </tr>
77 |                 {% endfor %}
78 |             </tbody>
79 |         </table>
80 |     </div>
81 | 
82 |     <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
83 |     <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
84 |     <!-- Include all compiled plugins (below), or include individual files as needed -->
85 |     <script src="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/js/bootstrap.min.js"></script>
86 | </body>
87 | </html>
88 | 


--------------------------------------------------------------------------------