Atualização para a V3 API

.gitignore

@@ -0,0 +1,8 @@
+# VSCode
+##########################
+.history/
+.svn/
+
+!.vendor/
+.vendor/*
+!.vendor/.gitkeep

README.md

@@ -183,10 +183,10 @@ $action123 = $asaas->city()->getById(123);
 Documentação Oficial
 --------------------
 
-Obs.: Esta é uma API não oficial. Foi feita com base na documentação disponibilizada [neste link](https://docs.google.com/document/d/1XUJRHY_0nd45CzFK5EmjDK92qgaQJGMxT0rjZriTk-g).
+Obs.: Esta é uma API não oficial baseada na API ASAAS v3. A documentação oficial da API ASAAS está disponibilizada [neste link](https://asaasv3.docs.apiary.io).
 
 
-Creditos
+Créditos
 --------
 
 * [Agência Softr Ltda - www.softr.com.br](http://www.softr.com.br)

composer.json

@@ -1,5 +1,5 @@
 {
-    "name"       : "softr/asaas-php-sdk",
+    "name"       : "lupainformatica/asaas-php-sdk",
     "type"       : "library",
     "description": "Asaas.com PHP API Wrapper",
     "keywords"   : ["Asaas", "API", "Payment SaaS", "Credit Card", "Boleto"],
@@ -31,4 +31,4 @@
         }
     },
     "minimum-stability": "dev"
-}
+}

src/Adapter/GuzzleHttpAdapter.php

@@ -41,7 +41,7 @@ class GuzzleHttpAdapter implements AdapterInterface
      */
     public function __construct($token, ClientInterface $client = null)
     {
-        if(version_compare(ClientInterface::VERSION, '6') === 1)
+        if(version_compare(ClientInterface::MAJOR_VERSION, '6') === 1)
         {
             $this->client = $client ?: new Client(['headers' => ['access_token' => $token]]);
         }
@@ -119,7 +119,7 @@ public function put($url, $content = '')
     public function post($url, $content = '')
     {
         $options = [];
-        $options['form_params'] = $content;
+        $options['json'] = $content;
 
         try
         {
@@ -161,7 +161,18 @@ protected function handleError()
         $code = (int) $this->response->getStatusCode();
 
         $content = json_decode($body);
+
+		$errors = [];
+		if (isset($content->errors)) {
+			foreach ((array)$content->errors as $error) {
+				$errors[] = $error->code . ': ' . $error->description;
+			}
+		}
+
+		if (!empty($errors)) {
+			throw new HttpException(implode('<br>', $errors), $code);
+		}
 
         throw new HttpException(isset($content->message) ? $content->message : 'Request not processed.', $code);
     }
-}
+}

src/Api/AbstractApi.php

@@ -16,14 +16,21 @@ abstract class AbstractApi
      *
      * @var string
      */
-    const ENDPOINT_PRODUCAO = 'https://www.asaas.com/api/v2';
+    const ENDPOINT_PRODUCAO = 'https://api.asaas.com/v3';
 
     /**
      * Endpoint Homologação
      *
      * @var string
      */
-    const ENDPOINT_HOMOLOGACAO = 'http://homolog.asaas.com/api/v2';
+    const ENDPOINT_HOMOLOGACAO = 'https://sandbox.asaas.com/api/v3';
+
+    /**
+     * Endpoint Sandbox
+     *
+     * @var string
+     */
+    const ENDPOINT_SANDBOX = 'https://sandbox.asaas.com/api/v3';
 
     /**
      * Http Adapter Instance
@@ -54,7 +61,16 @@ public function __construct(AdapterInterface $adapter, $ambiente = 'producao')
     {
         $this->adapter = $adapter;
 
-        $this->endpoint = $ambiente == 'homologacao' ? static::ENDPOINT_HOMOLOGACAO : static::ENDPOINT_PRODUCAO;
+        switch ($ambiente) {
+            case 'sandbox':
+                $this->endpoint = static::ENDPOINT_SANDBOX;
+                break;
+            case 'homologacao':
+                $this->endpoint = static::ENDPOINT_HOMOLOGACAO;
+                break;
+            default:
+                $this->endpoint = static::ENDPOINT_PRODUCAO;
+        }
     }
 
     /**
@@ -79,4 +95,4 @@ public function getMeta()
     {
         return $this->meta;
     }
-}
+}

src/Api/Customer.php

@@ -27,7 +27,7 @@ public function getAll(array $filters = [])
 
         return array_map(function($customer)
         {
-            return new CustomerEntity($customer->customer);
+            return new CustomerEntity($customer);
         }, $customers->data);
     }
 
@@ -46,23 +46,37 @@ public function getById($id)
         return new CustomerEntity($customer);
     }
 
+    /**
+     * Get Customer By Name
+     *
+     * @param   string  $name  Customer Name
+     * @return  CustomerEntity
+     */
+    public function getByName($name)
+    {
+        return $this->getAll(['name' => $name]);
+    }
+
+    /**
+     * Get Customer By CPF/CNPJ
+     *
+     * @param   string  $cpfCnpj  Customer CPF / CNPJ
+     * @return  CustomerEntity
+     */
+    public function getByCpfCnpj($cpfCnpj)
+    {
+        return $this->getAll(['cpfCnpj' => $cpfCnpj]);
+    }
+
     /**
      * Get Customer By Email
      *
-     * @param   string  $email  Customer Id
+     * @param   string  $email  Customer e-mail
      * @return  CustomerEntity
      */
     public function getByEmail($email)
     {
-        foreach($this->getAll(['name' => $email]) as $customer)
-        {
-            if($customer->email == $email)
-            {
-                return $customer;
-            }
-        }
-
-        return;
+        return $this->getAll(['email' => $email]);
     }
 
     /**

src/Api/Payment.php

@@ -1,4 +1,5 @@
 <?php
+
 namespace Softr\Asaas\Api;
 
 // Entities
@@ -11,6 +12,23 @@
  */
 class Payment extends \Softr\Asaas\Api\AbstractApi
 {
+    /**
+     * Get paginate payments
+     *
+     * @param   array  $filters  (optional) Filters Array
+     * @return  array  Payments Array
+     */
+    public function getPaginate(array $filters = [])
+    {
+        $payments = $this->adapter->get(sprintf('%s/payments?%s', $this->endpoint, http_build_query($filters)));
+
+        $payments = json_decode($payments);
+
+        $this->extractMeta($payments);
+
+        return $payments;
+    }
+
     /**
      * Get all payments
      *
@@ -25,8 +43,7 @@ public function getAll(array $filters = [])
 
         $this->extractMeta($payments);
 
-        return array_map(function($payment)
-        {
+        return array_map(function ($payment) {
             return new PaymentEntity($payment);
         }, $payments->data);
     }
@@ -61,8 +78,7 @@ public function getByCustomer($customerId, array $filters = [])
 
         $this->extractMeta($payments);
 
-        return array_map(function($payment)
-        {
+        return array_map(function ($payment) {
             return new PaymentEntity($payment);
         }, $payments->data);
     }
@@ -82,8 +98,7 @@ public function getBySubscription($subscriptionId)
 
         $this->extractMeta($payments);
 
-        return array_map(function($payment)
-        {
+        return array_map(function ($payment) {
             return new PaymentEntity($payment);
         }, $payments->data);
     }
@@ -119,6 +134,22 @@ public function update($id, array $data)
         return new PaymentEntity($payment);
     }
 
+    /**
+     * Refund a Payment By Id
+     *
+     * @param   string  $id    Payment Id
+     * @param   array   $data  Payment Data
+     * @return  PaymentEntity
+     */
+    public function refund($id, array $data)
+    {
+        $payment = $this->adapter->post(sprintf('%s/payments/%s/refund', $this->endpoint, $id), $data);
+
+        $payment = json_decode($payment);
+
+        return new PaymentEntity($payment);
+    }
+
     /**
      * Delete Payment By Id
      *
@@ -128,4 +159,14 @@ public function delete($id)
     {
         $this->adapter->delete(sprintf('%s/payments/%s', $this->endpoint, $id));
     }
-}
+
+    /**
+     * Delete Payment By Id
+     *
+     * @param  string|int  $id  Payment Id
+     */
+    public function deleteInstallment($id)
+    {
+        $this->adapter->delete(sprintf('%s/installments/%s', $this->endpoint, $id));
+    }
+}

src/Api/Subscription.php

@@ -1,4 +1,5 @@
 <?php
+
 namespace Softr\Asaas\Api;
 
 // Entities
@@ -11,6 +12,23 @@
  */
 class Subscription extends \Softr\Asaas\Api\AbstractApi
 {
+    /**
+     * Get paginate subscriptions
+     *
+     * @param   array  $filters  (optional) Filters Array
+     * @return  array  Subscriptions Array
+     */
+    public function getPaginate(array $filters = [])
+    {
+        $subscriptions = $this->adapter->get(sprintf('%s/subscriptions?%s', $this->endpoint, http_build_query($filters)));
+
+        $subscriptions = json_decode($subscriptions);
+
+        $this->extractMeta($subscriptions);
+
+        return $subscriptions;
+    }
+
     /**
      * Get all subscriptions
      *
@@ -25,9 +43,8 @@ public function getAll(array $filters = [])
 
         $this->extractMeta($subscriptions);
 
-        return array_map(function($subscription)
-        {
-            return new SubscriptionEntity($subscription->subscription);
+        return array_map(function ($subscription) {
+            return new SubscriptionEntity($subscription);
         }, $subscriptions->data);
     }
 
@@ -61,9 +78,8 @@ public function getByCustomer($customerId)
 
         $this->extractMeta($subscriptions);
 
-        return array_map(function($subscription)
-        {
-            return new SubscriptionEntity($subscription->subscription);
+        return array_map(function ($subscription) {
+            return new SubscriptionEntity($subscription);
         }, $subscriptions->data);
     }
 
@@ -107,4 +123,4 @@ public function delete($id)
     {
         $this->adapter->delete(sprintf('%s/subscriptions/%s', $this->endpoint, $id));
     }
-}
+}

src/Entity/AbstractEntity.php

@@ -66,7 +66,7 @@ protected static function convertDateTime($date)
             return;
         }
 
-        $date = \DateTime::createFromFormat('d/m/Y', $date);
+        $date = new \DateTime($date);
 
         if(!$date)
         {
@@ -91,4 +91,4 @@ protected static function convertToCamelCase($str)
 
         return lcfirst(preg_replace_callback('/(^|_)([a-z])/', $callback, $str));
     }
-}
+}