/**
  *
  * @param HttpConfig $httpConfig        	
  * @param string $request        	
  * @param mixed $options        	
  * @return mixed|void
  * @throws BitPagosConfigurationException
  * @throws BitPagosInvalidCredentialException
  * @throws BitPagosMissingCredentialException
  */
 public function handle($httpConfig, $request, $options)
 {
     $credential = $this->apiContext->getCredential();
     $config = $this->apiContext->getConfig();
     if (is_null($credential) and !empty($this->apiContext->getApiKey())) {
         $credential = false;
     }
     if (is_null($credential)) {
         // Try picking credentials from the config file
         $credMgr = CredentialManager::getInstance($config);
         $credValues = $credMgr->getCredentialObject();
         if (!is_array($credValues)) {
             throw new BitPagosMissingCredentialException("Empty or invalid credentials passed");
         }
         $credential = new OAuthTokenCredential($credValues['clientId'], $credValues['clientSecret']);
     }
     if ((is_null($credential) or !$credential instanceof OAuthTokenCredential) and empty($this->apiContext->getApiKey())) {
         throw new BitPagosInvalidCredentialException("Invalid credentials passed");
     }
     $httpConfig->setUrl(rtrim(trim($this->_getEndpoint($config)), '/') . (isset($options['path']) ? $options['path'] : ''));
     if (!array_key_exists("User-Agent", $httpConfig->getHeaders())) {
         $httpConfig->addHeader("User-Agent", BitPagosUserAgent::getValue(BitPagosConstants::SDK_NAME, BitPagosConstants::SDK_VERSION));
     }
     if (!is_null($credential) && $credential instanceof OAuthTokenCredential and is_null($httpConfig->getHeader('Authorization'))) {
         $httpConfig->addHeader('Authorization', "OAuth " . $credential->getAccessToken($config), false);
     }
     if ($credential === false and !empty($this->apiContext->getApiKey()) and is_null($httpConfig->getHeader('Authorization'))) {
         $httpConfig->addHeader('Authorization', "ApiKey " . $this->apiContext->getApiKey(), false);
     }
     // Add any additional Headers that they may have provided
     $headers = $this->apiContext->getRequestHeaders();
     foreach ($headers as $key => $value) {
         $httpConfig->addHeader($key, $value);
     }
 }
 /**
  *
  * @param array $handlers
  *        	Array of handlers
  * @param string $path
  *        	Resource path relative to base service endpoint
  * @param string $method
  *        	HTTP method - one of GET, POST, PUT, DELETE, PATCH etc
  * @param string $data
  *        	Request payload
  * @param array $headers
  *        	HTTP headers
  * @return mixed
  * @throws \BitPagos\Exception\BitPagosConnectionException
  */
 public function execute($handlers = array(), $path, $method, $data = '', $headers = array())
 {
     $config = $this->apiContext->getConfig();
     $httpConfig = new HttpConfig(null, $method, $config);
     $headers = $headers ? $headers : array();
     $httpConfig->setHeaders($headers + array('Content-Type' => 'application/json'));
     /**
      *
      * @var \BitPagos\Handler\IBitPagosHandler $handler
      */
     foreach ($handlers as $handler) {
         if (!is_object($handler)) {
             $fullHandler = "\\" . (string) $handler;
             $handler = new $fullHandler($this->apiContext);
         }
         $handler->handle($httpConfig, $data, array('path' => $path, 'apiContext' => $this->apiContext));
     }
     $this->httpConnection = new HttpConnection($httpConfig, $config);
     $response = $this->httpConnection->execute($data);
     return $response;
 }
 /**
  * Executes an HTTP request
  *
  * @param string $data
  *        	query string OR POST content as a string
  * @return mixed
  * @throws BitPagosConnectionException
  */
 public function execute($data)
 {
     //Initialize the logger
     $this->logger->info($this->httpConfig->getMethod() . ' ' . $this->httpConfig->getUrl());
     //Initialize Curl Options
     $ch = curl_init($this->httpConfig->getUrl());
     curl_setopt_array($ch, $this->httpConfig->getCurlOptions());
     curl_setopt($ch, CURLOPT_URL, $this->httpConfig->getUrl());
     curl_setopt($ch, CURLOPT_HEADER, true);
     curl_setopt($ch, CURLINFO_HEADER_OUT, true);
     curl_setopt($ch, CURLOPT_HTTPHEADER, $this->getHttpHeaders());
     //Determine Curl Options based on Method
     switch ($this->httpConfig->getMethod()) {
         case 'POST':
             curl_setopt($ch, CURLOPT_POST, true);
             curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
             break;
         case 'PUT':
         case 'PATCH':
         case 'DELETE':
             curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
             break;
     }
     //Default Option if Method not of given types in switch case
     if ($this->httpConfig->getMethod() != NULL) {
         curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $this->httpConfig->getMethod());
     }
     //Logging Each Headers for debugging purposes
     foreach ($this->getHttpHeaders() as $header) {
         //TODO: Strip out credentials and other secure info when logging.
         // $this->logger->debug($header);
     }
     //Execute Curl Request
     $result = curl_exec($ch);
     //Retrieve Response Status
     $this->httpStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);
     //Retry if Certificate Exception
     if (curl_errno($ch) == 60) {
         $this->logger->info("Invalid or no certificate authority found - Retrying using bundled CA certs file");
         curl_setopt($ch, CURLOPT_CAINFO, dirname(__FILE__) . '/cacert.pem');
         $result = curl_exec($ch);
         //Retrieve Response Status
         $this->httpStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);
     }
     //Retry if Failing
     $retries = 0;
     if (in_array($this->httpStatus, self::$retryCodes) && $this->httpConfig->getHttpRetryCount() != null) {
         $this->logger->info("Got {$this->httpStatus} response from server. Retrying");
         do {
             $result = curl_exec($ch);
             //Retrieve Response Status
             $this->httpStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);
         } while (in_array($this->httpStatus, self::$retryCodes) && ++$retries < $this->httpConfig->getHttpRetryCount());
     }
     //Throw Exception if Retries and Certificates doenst work
     if (curl_errno($ch)) {
         $ex = new BitPagosConnectionException($this->httpConfig->getUrl(), curl_error($ch), curl_errno($ch));
         curl_close($ch);
         throw $ex;
     }
     // Get Request and Response Headers
     $this->requestHeaders = curl_getinfo($ch, CURLINFO_HEADER_OUT);
     //Using alternative solution to CURLINFO_HEADER_SIZE as it throws invalid number when called using PROXY.
     $responseHeaderSize = strlen($result) - curl_getinfo($ch, CURLINFO_SIZE_DOWNLOAD);
     $this->responseHeaders = substr($result, 0, $responseHeaderSize);
     $result = substr($result, $responseHeaderSize);
     $this->logger->debug("Request Headers \t: " . str_replace("\r\n", ", ", $this->requestHeaders));
     $this->logger->debug(($data && $data != '' ? "Request Data\t\t: " . $data : "No Request Payload") . "\n" . str_repeat('-', 128) . "\n");
     $this->logger->info("Response Status \t: " . $this->httpStatus);
     $this->logger->debug("Response Headers\t: " . str_replace("\r\n", ", ", $this->responseHeaders));
     //Close the curl request
     curl_close($ch);
     //More Exceptions based on HttpStatus Code
     if (in_array($this->httpStatus, self::$retryCodes)) {
         $ex = new BitPagosConnectionException($this->httpConfig->getUrl(), "Got Http response code {$this->httpStatus} when accessing {$this->httpConfig->getUrl()}. " . "Retried {$retries} times.");
         $ex->setData($result);
         $this->logger->error("Got Http response code {$this->httpStatus} when accessing {$this->httpConfig->getUrl()}. " . "Retried {$retries} times." . $result);
         $this->logger->debug("\n\n" . str_repeat('=', 128) . "\n");
         throw $ex;
     } else {
         if ($this->httpStatus < 200 || $this->httpStatus >= 300) {
             $ex = new BitPagosConnectionException($this->httpConfig->getUrl(), "Got Http response code {$this->httpStatus} when accessing {$this->httpConfig->getUrl()}.", $this->httpStatus);
             $ex->setData($result);
             $this->logger->error("Got Http response code {$this->httpStatus} when accessing {$this->httpConfig->getUrl()}. " . $result);
             $this->logger->debug("\n\n" . str_repeat('=', 128) . "\n");
             throw $ex;
         }
     }
     $this->logger->debug(($result && $result != '' ? "Response Data \t: " . $result : "No Response Body") . "\n\n" . str_repeat('=', 128) . "\n");
     //Return result object
     $this->responseBody =& $result;
     return $result;
 }