增加线下渠道的支持和线下扫码撤销接口

Author: phx

README.md

@@ -82,6 +82,7 @@ try {
 | `$gateway->purchase()` | 创建 Charge |
 | `$gateway->fetchTransaction()` | 查询单笔 Charge |
 | `$gateway->fetchTransactionList()` | 查询 Charge 列表 |
+| `$gateway->reverse()` | Charge 撤销（仅支持isv线下渠道，如已支付会退款） |
 | `$gateway->refund()` | 创建退款 |
 | `$gateway->fetchRefund()` | 查询单笔退款 |
 | `$gateway->fetchRefundList()` | 查询退款列表 |
@@ -152,6 +153,16 @@ $transaction->setTransactionReference('ch_DaHuXHjHeX98GO84COzbfTiP');
 $response = $transaction->send();
 ```
 
+### Reverse Charge (撤销单笔 Charge，只支持isv_*线下渠道。如已付款，则撤销会退款)
+```php
+/**
+ * @var \Omnipay\Pingpp\Message\ReverseTransactionRequest $transaction
+ */
+$transaction = $gateway->reverse();
+$transaction->setTransactionReference('ch_DaHuXHjHeX98GO84COzbfTiP');
+$response = $transaction->send();
+```
+
 ### Fetch Charge List (查询 Charge 列表)
 ```php
 /**

src/Common/Channels.php

@@ -164,4 +164,20 @@ abstract class Channels
      * 通联代付(Transfer)
      */
     const ALLINPAY = 'allinpay';
+
+    /**
+     * 线下扫码（主扫）
+     */
+    const ISV_QR = 'isv_qr';
+
+    /**
+     * 线下扫码（被扫）
+     */
+    const ISV_SCAN = 'isv_scan';
+
+    /**
+     * 线下扫码（固定码）
+     */
+    const ISV_WAP = 'isv_wap';
+
 }

src/Gateway.php

@@ -143,6 +143,17 @@ public function refund(array $parameters = array())
         return $this->createRequest(\Omnipay\Pingpp\Message\RefundRequest::class, $parameters);
     }
 
+    /**
+     * Reverse Charge Request (ISV_* channels supported only)
+     *
+     * @param array $parameters
+     * @return \Omnipay\Common\Message\AbstractRequest
+     */
+    public function reverse(array $parameters = array())
+    {
+        return $this->createRequest(\Omnipay\Pingpp\Message\ReverseTransactionRequest::class, $parameters);
+    }
+
     /**
      * Fetch Transaction Request.
      *

src/Message/ReverseTransactionRequest.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Pingpp Reverse Transaction Request.
+ */
+namespace Omnipay\Pingpp\Message;
+
+/**
+ * Pingpp Reverse Transaction Request.
+ */
+class ReverseTransactionRequest extends AbstractRequest
+{
+    /**
+     * @return array
+     * @throws \Omnipay\Common\Exception\InvalidRequestException
+     */
+    public function getData()
+    {
+        $this->validate('transactionReference');
+
+        $data = array();
+
+        return $data;
+    }
+
+    /**
+     * @return string
+     */
+    public function getEndpoint()
+    {
+        return $this->endpoint.'/charges/'.$this->getTransactionReference().'/reverse';
+    }
+
+}