PHPAY-40: Merge branch 'develop' of github.com:phpay-io/phpay into 40-create-tests-to-created-features

Author: mariolucasdev

examples/efi/charges.php

@@ -43,3 +43,46 @@
         'status'      => 'unpaid',
     ])
     ->getAll();
+
+/**
+ * find charge by id
+ *
+ * @return array charge
+ */
+$phpay
+    ->charge()
+    ->find($chargeId);
+
+/**
+ * confirm receipt
+ *
+ * @return array charge
+ */
+$phpay
+    ->charge()
+    ->confirmReceipt($chargeId);
+
+/**
+ * cancel charge
+ */
+$phpay
+    ->charge()
+    ->cancel($chargeId);
+
+/**
+ * update due date
+ */
+$phpay
+    ->charge()
+    ->updateDueDate($chargeId, $dueDate);
+
+/**
+ * update billet metadata
+ * notification_url and custom_id
+ */
+$phpay
+    ->charge()
+    ->updateMetadata($chargeId, [
+        'notification_url' => $notificationUrl,
+        'custom_id'        => $customId,
+    ]);

src/Gateways/Efi/Resources/Charge/Charge.php

@@ -96,6 +96,16 @@ public function getAll(): array
         return $this->get('v1/charges', $this->queryParams);
     }
 
+    /**
+     * find charge by id
+     *
+     * @return array<array|mixed>
+     */
+    public function find(string $id): array
+    {
+        return $this->get("v1/charge/{$id}");
+    }
+
     /**
      * create charge
      *
@@ -122,71 +132,63 @@ public function create(): array
     }
 
     /**
-     * update charge
+     * update billet metadata
+     * notification_url and custom_id
      *
      * @param string $id
      * @param array<mixed> $data
      * @return array<mixed>
      */
-    public function update(string $id, array $data): array
+    public function updateMetadata(string $id, array $data): array
     {
-        return $this->put("payments/{$id}", $data);
+        return $this->put("v1/charge/{$id}/metadata", $data);
     }
 
     /**
-     * destroy charge
-     *
-     * @param string $id
-     * @return bool
-     */
-    public function destroy(string $id): bool
-    {
-        return $this->delete("payments/{$id}");
-    }
-
-    /**
-     * get status charge
+     * cancel charge
      *
      * @param string $id
      * @return array<array|mixed>
      */
-    public function getStatus(string $id): array
+    public function cancel(string $id): array
     {
-        return $this->get("payments/{$id}/status");
+        return $this->put("v1/charge/{$id}/cancel", []);
     }
 
     /**
-     * get digitable line
+     * update due date
      *
      * @param string $id
-     * @return mixed
+     * @param string $dueDate
+     * @return array<array|mixed>
      */
-    public function getDigitableLine(string $id): mixed
+    public function updateDueDate(string $id, string $dueDate): array
     {
-        return $this->get("payments/{$id}/identificationField")['identificationField'];
+        return $this->put("v1/charge/{$id}/billet", [
+            'expire_at' => $dueDate,
+        ]);
     }
 
     /**
-     * get qrcode pix
+     * get status charge
      *
      * @param string $id
      * @return array<array|mixed>
      */
-    public function getQrCodePix(string $id): array
+    public function getStatus(string $id): array
     {
-        return $this->get("payments/{$id}/pixQrCode");
+        return $this->get("payments/{$id}/status");
     }
 
     /**
      * confirm receipt
      *
      * @param string $id
-     * @param array<mixed> $data
      * @return array<mixed>
      */
-    public function confirmReceipt(string $id, array $data): array
+    public function confirmReceipt(string $id): array
     {
-        return $this->post("payments/{$id}/receiveInCash", $data);
+        return $this->put("v1/charge/{$id}/settle", []);
     }
 
     /**

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

@@ -13,6 +13,14 @@ interface ChargeInterface
      */
     public function getAll(): array;
 
+    /**
+     * find charge by id
+     *
+     * @param string  $id
+     * @return array<array|mixed>
+     */
+    public function find(string $id): array;
+
     /**
      * set customer
      *
@@ -28,4 +36,35 @@ public function setCustomer(array $customer): Charge;
      * @return ChargeInterface
      */
     public function setQueryParams(array $queryParams): ChargeInterface;
+
+    /**
+     * @param string $id
+     * @return array<array|mixed>
+     */
+    public function confirmReceipt(string $id): array;
+
+    /**
+     * cancel charge by id
+     *
+     * @param string $id
+     * @return array<array|mixed>
+     */
+    public function cancel(string $id): array;
+
+    /**
+     * @param string $id
+     * @param string $dueDate
+     * @return array<array|mixed>
+     */
+    public function updateDueDate(string $id, string $dueDate): array;
+
+    /**
+     * update billet metadata
+     * notification_url and custom_id
+     *
+     * @param string $id
+     * @param array<mixed> $data
+     * @return array<mixed>
+     */
+    public function updateMetadata(string $id, array $data): array;
 }