vendor/stripe/stripe-php/lib/OAuth.php

   1 <?php
   2
   3 namespace Stripe;
   4
   5 abstract class OAuth
   6 {
   7     /**
   8      * Generates a URL to Stripe's OAuth form.
   9      *
  10      * @param array|null $params
  11      * @param array|null $opts
  12      *
  13      * @return string The URL to Stripe's OAuth form.
  14      */
  15     public static function authorizeUrl($params = null, $opts = null)
  16     {
  17         if (!$params) {
  18             $params = array();
  19         }
  20
  21         $base = ($opts && array_key_exists('connect_base', $opts)) ? $opts['connect_base'] : Stripe::$connectBase;
  22
  23         $params['client_id'] = self::_getClientId($params);
  24         if (!array_key_exists('response_type', $params)) {
  25             $params['response_type'] = 'code';
  26         }
  27         $query = Util\Util::urlEncode($params);
  28
  29         return $base . '/oauth/authorize?' . $query;
  30     }
  31
  32     /**
  33      * Use an authoriztion code to connect an account to your platform and
  34      * fetch the user's credentials.
  35      *
  36      * @param array|null $params
  37      * @param array|null $opts
  38      *
  39      * @return StripeObject Object containing the response from the API.
  40      */
  41     public static function token($params = null, $opts = null)
  42     {
  43         $base = ($opts && array_key_exists('connect_base', $opts)) ? $opts['connect_base'] : Stripe::$connectBase;
  44         $requestor = new ApiRequestor(null, $base);
  45         list($response, $apiKey) = $requestor->request(
  46             'post',
  47             '/oauth/token',
  48             $params,
  49             null
  50         );
  51         return Util\Util::convertToStripeObject($response->json, $opts);
  52     }
  53
  54     /**
  55      * Disconnects an account from your platform.
  56      *
  57      * @param array|null $params
  58      * @param array|null $opts
  59      *
  60      * @return StripeObject Object containing the response from the API.
  61      */
  62     public static function deauthorize($params = null, $opts = null)
  63     {
  64         if (!$params) {
  65             $params = array();
  66         }
  67
  68         $base = ($opts && array_key_exists('connect_base', $opts)) ? $opts['connect_base'] : Stripe::$connectBase;
  69         $requestor = new ApiRequestor(null, $base);
  70         $params['client_id'] = self::_getClientId($params);
  71         list($response, $apiKey) = $requestor->request(
  72             'post',
  73             '/oauth/deauthorize',
  74             $params,
  75             null
  76         );
  77         return Util\Util::convertToStripeObject($response->json, $opts);
  78     }
  79
  80     private static function _getClientId($params = null)
  81     {
  82         $clientId = ($params && array_key_exists('client_id', $params)) ? $params['client_id'] : null;
  83         if ($clientId === null) {
  84             $clientId = Stripe::getClientId();
  85         }
  86         if ($clientId === null) {
  87             $msg = 'No client_id provided.  (HINT: set your client_id using '
  88               . '"Stripe::setClientId(<CLIENT-ID>)".  You can find your client_ids '
  89               . 'in your Stripe dashboard at '
  90               . 'https://dashboard.stripe.com/account/applications/settings, '
  91               . 'after registering your account as a platform. See '
  92               . 'https://stripe.com/docs/connect/standard-accounts for details, '
  93               . 'or email support@stripe.com if you have any questions.';
  94             throw new Error\Authentication($msg);
  95         }
  96         return $clientId;
  97     }
  98 }