추가: Payment 결제 조회, 결제 취소

Author: getsolaris

README.md

@@ -62,7 +62,50 @@ $payment = TossPayments::for(Payment::class)
 return $payment->json();
 ```
 
+### [paymentKey로 결제 조회](https://docs.tosspayments.com/reference#paymentkey%EB%A1%9C-%EA%B2%B0%EC%A0%9C-%EC%A1%B0%ED%9A%8C)
 
+GET /v1/payments/{paymentKey}
+
+```php
+use Getsolaris\LaravelTossPayments\TossPayments;
+use Getsolaris\LaravelTossPayments\Attributes\Payment;
+
+$payment = TossPayments::for(Payment::class)
+    ->paymentKey($paymentKey)
+    ->get();
+
+return $payment->json();
+```
+
+### [orderId로 결제 조회](https://docs.tosspayments.com/reference#orderid%EB%A1%9C-%EA%B2%B0%EC%A0%9C-%EC%A1%B0%ED%9A%8C)
+
+GET /v1/payments/orders/{orderId}
+
+```php
+use Getsolaris\LaravelTossPayments\TossPayments;
+use Getsolaris\LaravelTossPayments\Attributes\Payment;
+
+$payment = TossPayments::for(Payment::class)
+    ->orderId($orderId)
+    ->get();
+
+return $payment->json();
+```
+
+### [결제 취소](https://docs.tosspayments.com/reference#%EA%B2%B0%EC%A0%9C-%EC%B7%A8%EC%86%8C)
+
+POST /v1/payments/{paymentKey}/cancel
+
+```php
+use Getsolaris\LaravelTossPayments\TossPayments;
+use Getsolaris\LaravelTossPayments\Attributes\Payment;
+
+$payment = TossPayments::for(Payment::class)
+    ->paymentId($paymentId)
+    ->cancel(reason: $reason);
+
+return $payment->json();
+```
 
 ## [거래 (Transaction)](https://docs.tosspayments.com/reference#%EA%B1%B0%EB%9E%98)
 

src/Attributes/Payment.php

@@ -15,14 +15,14 @@ class Payment extends TossPayments implements AttributeInterface
     protected string $uri;
 
     /**
-     * @var string
+     * @var string|null
      */
-    protected string $paymentKey;
+    protected ?string $paymentKey = null;
 
     /**
-     * @var string
+     * @var string|null
      */
-    protected string $orderId;
+    protected ?string $orderId = null;
 
     /**
      * @var int
@@ -104,14 +104,17 @@ public function confirm(): PromiseInterface|Response
      */
     public function get(): PromiseInterface|Response
     {
-        return $this->client->get($this->createEndpoint('/'.$this->paymentKey));
+        return $this->client->get($this->createEndpoint('/'. ($this->paymentKey ?? 'orders/' . $this->orderId)));
     }
 
     /**
+     * @param  string  $reason
      * @return PromiseInterface|Response
      */
-    public function order(): PromiseInterface|Response
+    public function cancel(string $reason): PromiseInterface|Response
     {
-        return $this->client->get($this->createEndpoint('/orders/'.$this->orderId));
+        return $this->client->post($this->createEndpoint('/'.$this->paymentKey.'/cancel'), [
+            'cancelReason' => $reason,
+        ]);
     }
 }