PHPAY-31: fix: replace setFilters to setParams (#38)

Author: mariolucasdev

examples/asaas/charges.php

@@ -59,7 +59,7 @@
  */
 $phpay
     ->charge()
-    ->setFilters(['limit' => 5])
+    ->setQueryParams(['limit' => 5])
     ->getAll();
 
 /**
@@ -69,7 +69,7 @@
  */
 $phpay
     ->charge()
-    ->update($chargeCreated['id'], [
+    ->update($chargeId, [
         'description' => 'Teste de fatura atualizado',
     ]);
 
@@ -80,7 +80,7 @@
  */
 $phpay
     ->charge()
-    ->destroy($chargeCreated['id']);
+    ->destroy($chargeId);
 
 /**
  * restore charge
@@ -89,7 +89,7 @@
  */
 $phpay
     ->charge()
-    ->restore($chargeCreated['id']);
+    ->restore($chargeId);
 
 /**
  * get charge status
@@ -98,7 +98,7 @@
  */
 $phpay
     ->charge()
-    ->getStatus($chargeCreated['id']);
+    ->getStatus($chargeId);
 
 /**
  * get digitable line charge
@@ -107,7 +107,7 @@
  */
 $phpay
     ->charge()
-    ->getDigitableLine($chargeCreated['id']);
+    ->getDigitableLine($chargeId);
 
 /**
  * get qrcode charge
@@ -116,7 +116,7 @@
  */
 $qrcode = $phpay
     ->charge()
-    ->getQrCodePix($chargeCreated['id']);
+    ->getQrCodePix($chargeId);
 
 /**
  * confirm receipt charge
@@ -125,7 +125,7 @@
  */
 $confirmed = $phpay
     ->charge()
-    ->confirmReceipt($chargeCreated['id'], [
+    ->confirmReceipt($chargeId, [
         'paymentDate'    => date('Y-m-d'),
         'value'          => 100.00,
         'notifyCustomer' => true,
@@ -138,4 +138,4 @@
  */
 $phpay
     ->charge()
-    ->undoConfirmReceipt($chargeCreated['id']);
+    ->undoConfirmReceipt($chargeId);

src/Gateways/Asaas/Resources/Charge/Charge.php

@@ -23,7 +23,7 @@ class Charge implements ChargeInterface
     /**
      * @var array<mixed>
      */
-    private array $filter = [];
+    private array $queryParams = [];
 
     /**
      * construct
@@ -43,14 +43,14 @@ public function __construct(
     }
 
     /**
-     * set filters
+     * set query params
      *
-     * @param array<mixed> $filters
+     * @param array<mixed> $queryParams
      * @return ChargeInterface
      */
-    public function setFilters(array $filters): ChargeInterface
+    public function setQueryParams(array $queryParams): ChargeInterface
     {
-        $this->filter = $filters;
+        $this->queryParams = $queryParams;
 
         return $this;
     }
@@ -91,7 +91,7 @@ public function find(string $id): array
      */
     public function getAll(): array
     {
-        return $this->get('payments', $this->filter);
+        return $this->get('payments', $this->queryParams);
     }
 
     /**
@@ -161,7 +161,13 @@ public function getStatus(string $id): array
      */
     public function getDigitableLine(string $id): mixed
     {
-        return $this->get("payments/{$id}/identificationField")['identificationField'];
+        $charge = $this->get("payments/{$id}/identificationField");
+
+        if (isset($charge['identificationField'])) {
+            return $charge['identificationField'];
+        }
+
+        return null;
     }
 
     /**

src/Gateways/Asaas/Resources/Charge/Interface/ChargeInterface.php

@@ -60,12 +60,12 @@ public function restore(string $id): array;
     public function setCustomer(array $customer): ChargeInterface;
 
     /**
-     * set filter
+     * set query params
      *
-     * @param array<mixed> $filters
+     * @param array<mixed> $queryParams
      * @return ChargeInterface
      */
-    public function setFilters(array $filters): ChargeInterface;
+    public function setQueryParams(array $queryParams): ChargeInterface;
 
     /**
      * get status charge by id