bump to version 0.4.0

Added more advanced features:
  - cancel refund
  - cancel capture
  - bind card
  - remove card

Author: chris-at-mtt

CHANGES.md

@@ -1,3 +1,11 @@
+# 0.4.0
+
+* Added more advanced features:
+  - cancel refund
+  - cancel capture
+  - bind card
+  - remove card
+
 # 0.3.0
 
 * Added method to support pay-by-token

README.md

@@ -81,6 +81,14 @@ response_data_dict = client.refund(rec_trade_id, refund_amount)
 
 Docs: [https://docs.tappaysdk.com/tutorial/zh/back.html#refund-api](https://docs.tappaysdk.com/tutorial/zh/back.html#refund-api)
 
+### Cancel Refund
+
+```python
+response_data_dict = client.cancel_refund(rec_trade_id)
+```
+
+Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#refund-cancel-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#refund-cancel-api)
+
 ### Get payment record
 
 ```python
@@ -99,6 +107,14 @@ response_data_dict = client.capture_today(rec_trade_id)
 
 Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#cap-today-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#cap-today-api)
 
+### Cancel Capture
+
+```python
+response_data_dict = client.cancel_capture(rec_trade_id)
+```
+
+Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#cap-cancel-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#cap-cancel-api)
+
 ### Get transaction record
 
 ```python
@@ -107,6 +123,22 @@ response_data_dict = client.get_trade_history(rec_trade_id)
 
 Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#trade-history-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#trade-history-api)
 
+### Bind card
+
+```python
+response_data_dict = client.bind_card(prime, card_holder_data)
+```
+
+Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#bind-card-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#bind-card-api)
+
+### Remove card
+
+```python
+response_data_dict = client.remove_card(card_key, card_token
+```
+
+Docs: [https://docs.tappaysdk.com/tutorial/zh/advanced.html#remove-card-api](https://docs.tappaysdk.com/tutorial/zh/advanced.html#remove-card-api)
+
 
 License
 -------

tappay/__init__.py

@@ -21,7 +21,7 @@
 
 logger = logging.getLogger("tappay")
 
-__version__ = '0.3.0'
+__version__ = '0.4.0'
 
 
 class Exceptions(object):
@@ -269,6 +269,23 @@ def capture_today(self, rec_trade_id):
 
         return self.__post_with_partner_key('/tpc/transaction/cap', params)
 
+    def cancel_capture(self, rec_trade_id):
+
+        """
+        Cancel a specific capture
+        Ref: https://docs.tappaysdk.com/tutorial/zh/advanced.html#cap-cancel-api
+        :param str rec_trade_id: Transaction record ID from TapPay
+        """
+
+        params = {
+            "rec_trade_id": rec_trade_id,
+        }
+
+        return self.__post_with_partner_key(
+            '/tpc/transaction/cap/cancel',
+            params
+        )
+
     def get_trade_history(self, rec_trade_id):
 
         """
@@ -286,6 +303,82 @@ def get_trade_history(self, rec_trade_id):
             params
         )
 
+    def bind_card(self,
+                  prime,
+                  card_holder_data,
+                  **kwargs):
+
+        """
+        Bind new credit card
+        Ref: https://docs.tappaysdk.com/tutorial/zh/advanced.html#bind-card-api
+        :param str prime: The "prime token"
+        :param CardHolderData card_holder_data: Info of card holder
+        """
+
+        # validate parameter types
+        if not isinstance(card_holder_data, Models.CardHolderData):
+            raise TypeError(
+                "expected `CardHolderData` type for "
+                "parameter `card_holder_data`, {} found".format(
+                    type(card_holder_data)))
+
+        params = {
+            "prime": prime,
+            "currency": Models.Currencies.TWD,
+            "cardholder": card_holder_data.to_dict(),
+        }
+
+        # add additional keyword arguments
+        if kwargs:
+            params.update(**kwargs)
+
+        return self.__post_with_partner_key_and_merchant_id(
+            '/tpc/card/bind',
+            params
+        )
+
+    def remove_card(self,
+                    card_key,
+                    card_token):
+
+        """
+        Remove bound credit card
+        Ref: https://docs.tappaysdk.com/tutorial/zh/advanced.html#remove-card-api
+        :param str card_key: Card key
+        :param str card_token: Card token
+        """
+
+        params = {
+            "card_key": card_key,
+            "card_token": card_token,
+        }
+
+        return self.__post_with_partner_key(
+            '/tpc/card/remove',
+            params
+        )
+
+    def cancel_refund(self, rec_trade_id, **kwargs):
+
+        """
+        Cancel a single refund
+        Ref: https://docs.tappaysdk.com/tutorial/zh/advanced.html#refund-cancel-api
+        :param str rec_trade_id: Transaction record ID from TapPay
+        """
+
+        params = {
+            "rec_trade_id": rec_trade_id,
+        }
+
+        # add additional keyword arguments
+        if kwargs:
+            params.update(**kwargs)
+
+        return self.__post_with_partner_key(
+            '/tpc/transaction/refund/cancel',
+            params
+        )
+
     # Utility methods
 
     def __post_with_partner_key(self, request_uri, params):