가상계좌 발급 요청 구현

Author: getsolaris

src/Attributes/Payment.php

@@ -3,6 +3,7 @@
 namespace Getsolaris\LaravelTossPayments\Attributes;
 
 use Getsolaris\LaravelTossPayments\Contracts\AttributeInterface;
+use Getsolaris\LaravelTossPayments\Objects\CashReceipt;
 use Getsolaris\LaravelTossPayments\Objects\RefundReceiveAccount;
 use Getsolaris\LaravelTossPayments\TossPayments;
 use GuzzleHttp\Promise\PromiseInterface;
@@ -16,14 +17,34 @@ class Payment extends TossPayments implements AttributeInterface
     protected string $uri;
 
     /**
-     * @var string|null
+     * @var string
+     */
+    protected string $paymentKey;
+
+    /**
+     * @var string
+     */
+    protected string $orderId;
+
+    /**
+     * @var string
+     */
+    protected string $cancelReason;
+
+    /**
+     * @var string
      */
-    protected ?string $paymentKey = null;
+    protected string $orderName;
 
     /**
-     * @var string|null
+     * @var string
      */
-    protected ?string $orderId = null;
+    protected string $customerName;
+
+    /**
+     * @var string
+     */
+    protected string $bank;
 
     /**
      * @var int
@@ -48,11 +69,16 @@ public function initializeUri(): static
 
     /**
      * @param  string|null  $endpoint
+     * @param  bool  $withUri
      * @return string
      */
-    public function createEndpoint(?string $endpoint): string
+    public function createEndpoint(?string $endpoint, bool $withUri = true): string
     {
-        return $this->url.$this->uri.$this->start($endpoint);
+        if ($withUri) {
+            return $this->url.$this->uri.$this->start($endpoint);
+        }
+
+        return $this->url.$this->start($endpoint);
     }
 
     /**
@@ -110,23 +136,29 @@ public function get(): PromiseInterface|Response
 
     /**
      * @param  string  $cancelReason
+     * @return $this
+     */
+    public function cancelReason(string $cancelReason): static
+    {
+        $this->cancelReason = $cancelReason;
+
+        return $this;
+    }
+
+    /**
      * @param  int|null  $cancelAmount
      * @param  RefundReceiveAccount|null  $refundReceiveAccount
      * @param  int|null  $taxFreeAmount
      * @param  int|null  $refundableAmount
      * @return PromiseInterface|Response
      */
     public function cancel(
-        string $cancelReason,
         ?int $cancelAmount = null,
         ?RefundReceiveAccount $refundReceiveAccount = null,
         ?int $taxFreeAmount = null,
         ?int $refundableAmount = null
     ): PromiseInterface|Response {
-        $parameters = [
-            'cancelReason' => $cancelReason,
-        ];
-
+        $parameters = [];
         if ($cancelAmount) {
             $parameters['cancelAmount'] = $cancelAmount;
         }
@@ -143,6 +175,117 @@ public function cancel(
             $parameters['refundableAmount'] = $refundableAmount;
         }
 
-        return $this->client->post($this->createEndpoint('/'.$this->paymentKey.'/cancel'), $parameters);
+        return $this->client->post($this->createEndpoint('/'.$this->paymentKey.'/cancel'), [
+            'cancelReason' => $this->cancelReason,
+        ] + $parameters);
+    }
+
+    /**
+     * @param  string  $orderName
+     * @return $this
+     */
+    public function orderName(string $orderName): static
+    {
+        $this->orderName = $orderName;
+
+        return $this;
+    }
+
+    /**
+     * @param  string  $customerName
+     * @return $this
+     */
+    public function customerName(string $customerName): static
+    {
+        $this->customerName = $customerName;
+
+        return $this;
+    }
+
+    /**
+     * @param  string  $bank
+     * @return $this
+     */
+    public function bank(string $bank): static
+    {
+        $this->bank = $bank;
+
+        return $this;
+    }
+
+    /**
+     * @param  string|null  $accountType
+     * @param  string|null  $accountKey
+     * @param  int|null  $validHours
+     * @param  string|null  $dueDate
+     * @param  string|null  $customerEmail
+     * @param  string|null  $customerMobilePhone
+     * @param  int|null  $taxFreeAmount
+     * @param  bool|null  $useEscrow
+     * @param  CashReceipt|null  $cashReceipt
+     * @param  array|null  $escrowProducts
+     * @return PromiseInterface|Response
+     */
+    public function virtualAccounts(
+        ?string $accountType = null,
+        ?string $accountKey = null,
+        ?int $validHours = null,
+        ?string $dueDate = null,
+        ?string $customerEmail = null,
+        ?string $customerMobilePhone = null,
+        ?int $taxFreeAmount = null,
+        ?bool $useEscrow = null,
+        ?CashReceipt $cashReceipt = null,
+        ?array $escrowProducts = null
+    ): PromiseInterface|Response
+    {
+        $parameters = [];
+        if ($accountType) {
+            $parameters['accountType'] = $accountType;
+        }
+
+        if ($accountKey) {
+            $parameters['accountKey'] = $accountKey;
+        }
+
+        if ($validHours) {
+            $parameters['validHours'] = $validHours;
+        }
+
+        if ($dueDate) {
+            $parameters['dueDate'] = $dueDate;
+        }
+
+        if ($customerEmail) {
+            $parameters['customerEmail'] = $customerEmail;
+        }
+
+        if ($customerMobilePhone) {
+            $parameters['customerMobilePhone'] = $customerMobilePhone;
+        }
+
+        if ($taxFreeAmount) {
+            $parameters['taxFreeAmount'] = $taxFreeAmount;
+        }
+
+        if ($useEscrow) {
+            $parameters['useEscrow'] = $useEscrow;
+        }
+
+        if ($cashReceipt) {
+            $parameters['cashReceipt'] = (array) $cashReceipt;
+        }
+
+        if ($escrowProducts) {
+            $parameters['escrowProducts'] = $escrowProducts;
+        }
+
+        return $this->client->post($this->createEndpoint('/virtual-accounts', false), [
+            'amount' => $this->amount,
+            'orderId' => $this->orderId,
+            'orderName' => $this->orderName,
+            'customerName' => $this->customerName,
+            'bank' => $this->bank,
+        ] + $parameters);
     }
 }

src/Attributes/Transaction.php

@@ -51,11 +51,16 @@ public function initializeUri(): static
 
     /**
      * @param  string|null  $endpoint
+     * @param  bool  $withUri
      * @return string
      */
-    public function createEndpoint(?string $endpoint): string
+    public function createEndpoint(?string $endpoint, bool $withUri = true): string
     {
-        return $this->url.$this->uri.$this->start($endpoint);
+        if ($withUri) {
+            return $this->url.$this->uri.$this->start($endpoint);
+        }
+
+        return $this->url.$this->start($endpoint);
     }
 
     /**

src/Contracts/AttributeInterface.php

@@ -8,5 +8,5 @@ public function __construct();
 
     public function initializeUri(): static;
 
-    public function createEndpoint(?string $endpoint, bool $hasUri): string;
+    public function createEndpoint(?string $endpoint, bool $withUri): string;
 }

src/Objects/CashReceipt.php

@@ -4,5 +4,25 @@
 
 class CashReceipt
 {
+    /**
+     * @var string
+     */
+    public string $type;
 
+    /**
+     * @var string
+     */
+    public string $registrationNumber;
+
+    /**
+     * @var string
+     */
+    public string $businessNumber;
+
+    public function __construct(string $type, string $registrationNumber, string $businessNumber)
+    {
+        $this->type = $type;
+        $this->registrationNumber = $registrationNumber;
+        $this->businessNumber = $businessNumber;
+    }
 }

src/Objects/RefundReceiveAccount.php

@@ -9,8 +9,14 @@ class RefundReceiveAccount
      */
     public string $bank;
 
+    /**
+     * @var string
+     */
     public string $accountNumber;
 
+    /**
+     * @var string
+     */
     public string $holderName;
 
     public function __construct(string $bank, string $accountNumber, string $holderName)