Change public API

Author: panda-madness

README.md

@@ -27,28 +27,45 @@ $request = $epay->buildRequest('payment', [
     'order_id' => 1234,
     'amount' => 1000,
     'currency' => 398,
-    fields => [
+    'fields' => [
         'RL' => 1234567,
         'abonent_id' => 1234567,
         ...
     ]
-])->getXML();
+]);
 
 // Статус платежа
-$request = $epay->buildRequest('status', ['order_id' => 1234])->getXML();
-
+$request = $epay->buildRequest('status', ['order_id' => 1234]);
+```
+```php
 //Обработка ответов Epay
-$response = $epay->parseResponse('payment', $_POST['response']); // $_POST только для примера, не делайте так в реальной жизни
 
-$client = new GuzzleHttp\Client();
-$resp = $client->get('https://testpay.kkb.kz/jsp/remote/checkOrdern.jsp?' . urlencode($request));
+// PostLink
+$response = $epay->parseResponse('payment', $_POST['response']);
+
+// Ответ на запрос о статусе платежа
+$curl = curl_init('https://testpay.kkb.kz/jsp/remote/checkOrdern.jsp?' . urlencode($request));
+
+curl_setopt_array($curl, array(
+    CURLOPT_RETURNTRANSFER => 1,
+    CURLOPT_POST => 1,
+    CURLOPT_POSTFIELDS => [
+        'Signed_Order_B64' => $request,
+        'BackLink' => 'asdads',
+        'PostLink' => 'asdads',
+        'FailurePostLink' => 'asdads',
+    ]
+));
+
+$result = curl_exec($curl);
+curl_close($curl);
 
-$response = $epay->parseResponse('status', $resp->getBody()->getContent());
+$response = $epay->parseResponse('status', $result);
 
 //verify() проверяет подпись ответа.
 if($response->verify()) {
-    print_r($response->getProps());
-    // getProps возвращает массив с параметрами ответа
+    print_r($response->get());
+    // get возвращает массив с параметрами ответа
 } else {
     echo 'Response not valid';
 }

composer.json

@@ -3,7 +3,7 @@
     "description": "A PHP client for the Qazkom Epay payment gateway",
     "type": "library",
     "license": "MIT",
-    "version": "0.0.4",
+    "version": "0.0.5",
     "authors": [
         {
             "name": "Margulan Baimbet",

src/Epay.php

@@ -20,9 +20,9 @@ public function __construct($params = [])
         $this->certManager = new CertManager($params);
     }
 
-    public function buildRequest(string $type, array $params): Requests\AbstractRequest
+    public function buildRequest(string $type, array $params)
     {
-        return RequestFactory::create($type, array_merge($params, $this->params), $this->certManager);
+        return RequestFactory::create($type, array_merge($params, $this->params), $this->certManager)->getXML();
     }
 
     public function parseResponse(string $type, string $body)

src/Requests/AbstractRequest.php

@@ -30,7 +30,7 @@ public function getXML() {
         return preg_replace('/^.+\n/', '', $this->xml->saveXML());
     }
 
-    private function signXML()
+    protected function signXML()
     {
         $merchant = $this->xml->xpath('/document/merchant')[0];
 

src/Requests/PaymentRequest.php

@@ -30,4 +30,12 @@ public function buildXML()
 
         return $document;
     }
+
+    public function getXML()
+    {
+        $this->signXML();
+        $xml = preg_replace('/^.+\n/', '', $this->xml->saveXML());
+
+        return base64_encode($xml);
+    }
 }

src/Responses/AbstractResponse.php

@@ -16,7 +16,10 @@ abstract class AbstractResponse
     /** @var array $props */
     protected $props = [];
 
+    /** @var string $merchantPath */
     protected $merchantPath = '';
+
+    /** @var string $merchantSignPath */
     protected $merchantSignPath = '';
 
     public function __construct(string $body, CertManager $certManager)
@@ -27,6 +30,15 @@ public function __construct(string $body, CertManager $certManager)
         $this->props = $this->fillProps($this->xml);
     }
 
+    /**
+     * @param \SimpleXMLElement $xml
+     * @return mixed
+     */
+    abstract protected function parse(\SimpleXMLElement $xml);
+
+    /**
+     * @return int
+     */
     public function verify()
     {
         $signature = strrev(
@@ -38,9 +50,10 @@ public function verify()
         return $this->certManager->verify($data, $signature);
     }
 
-    abstract protected function fillProps(\SimpleXMLElement $sxi);
-
-    public function getProps()
+    /**
+     * @return array
+     */
+    public function get()
     {
         return $this->props;
     }

src/Responses/PaymentResponse.php

@@ -8,7 +8,7 @@ class PaymentResponse extends AbstractResponse
     protected $merchantPath = '/document/bank/customer/merchant';
     protected $merchantSignPath = '/document/bank/customer/merchant_sign';
 
-    protected function fillProps(\SimpleXMLElement $sxi)
+    protected function fillProps(\SimpleXMLElement $sxi) : array
     {
         $props = [];
 

src/Responses/StatusResponse.php

@@ -8,7 +8,10 @@ class StatusResponse extends AbstractResponse
     protected $merchantPath = '/document/bank/merchant';
     protected $merchantSignPath = '/document/bank/merchant_sign';
 
-    protected function fillProps(\SimpleXMLElement $sxi)
+    /**
+     * @inheritdoc
+     */
+    protected function parse(\SimpleXMLElement $xml)
     {
         $props = [];
 
@@ -17,11 +20,11 @@ protected function fillProps(\SimpleXMLElement $sxi)
         $response = $this->xml->xpath('/document/bank/response')[0];
 
         foreach ($order->attributes() as $name => $value) {
-            $props['order_' . $name] = $value;
+            $props['order'][$name] = (string)$value;
         }
 
         foreach ($response->attributes() as $name => $value) {
-            $props['response_' . $name] = $value;
+            $props['response'][$name] = (string)$value;
         }
 
         return $props;