8 * Generates a URL to Stripe's OAuth form.
10 * @param array|null $params
11 * @param array|null $opts
13 * @return string The URL to Stripe's OAuth form.
15 public static function authorizeUrl($params = null, $opts = null)
17 $params = $params ?
: [];
19 $base = ($opts && array_key_exists('connect_base', $opts)) ?
$opts['connect_base'] : Stripe
::$connectBase;
21 $params['client_id'] = self
::_getClientId($params);
22 if (!array_key_exists('response_type', $params)) {
23 $params['response_type'] = 'code';
25 $query = Util\Util
::urlEncode($params);
27 return $base . '/oauth/authorize?' . $query;
31 * Use an authoriztion code to connect an account to your platform and
32 * fetch the user's credentials.
34 * @param array|null $params
35 * @param array|null $opts
37 * @return StripeObject Object containing the response from the API.
39 public static function token($params = null, $opts = null)
41 $base = ($opts && array_key_exists('connect_base', $opts)) ?
$opts['connect_base'] : Stripe
::$connectBase;
42 $requestor = new ApiRequestor(null, $base);
43 list($response, $apiKey) = $requestor->request(
49 return Util\Util
::convertToStripeObject($response->json
, $opts);
53 * Disconnects an account from your platform.
55 * @param array|null $params
56 * @param array|null $opts
58 * @return StripeObject Object containing the response from the API.
60 public static function deauthorize($params = null, $opts = null)
62 $params = $params ?
: [];
63 $base = ($opts && array_key_exists('connect_base', $opts)) ?
$opts['connect_base'] : Stripe
::$connectBase;
64 $requestor = new ApiRequestor(null, $base);
65 $params['client_id'] = self
::_getClientId($params);
66 list($response, $apiKey) = $requestor->request(
72 return Util\Util
::convertToStripeObject($response->json
, $opts);
75 private static function _getClientId($params = null)
77 $clientId = ($params && array_key_exists('client_id', $params)) ?
$params['client_id'] : null;
78 if ($clientId === null) {
79 $clientId = Stripe
::getClientId();
81 if ($clientId === null) {
82 $msg = 'No client_id provided. (HINT: set your client_id using '
83 . '"Stripe::setClientId(<CLIENT-ID>)". You can find your client_ids '
84 . 'in your Stripe dashboard at '
85 . 'https://dashboard.stripe.com/account/applications/settings, '
86 . 'after registering your account as a platform. See '
87 . 'https://stripe.com/docs/connect/standard-accounts for details, '
88 . 'or email support@stripe.com if you have any questions.';
89 throw new Error\
Authentication($msg);