python-payway 0.0.8__tar.gz → 0.0.9__tar.gz

{python_payway-0.0.8/python_payway.egg-info → python_payway-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-payway
-Version: 0.0.8
+Version: 0.0.9
 Summary: Python client for working with Westpac's PayWay REST API
 Author-email: Ben Napper <reppan197@gmail.com>
 License: MIT
@@ -201,6 +201,27 @@ Poll a transaction using the `get_transaction` method.
 transaction, errors = client.get_transaction(transaction.transaction_id)
 ```
 
+## Search transactions
+
+PayWay has no plain `GET /transactions` resource, only three search paths. Each returns a
+paginated list (20 per page, most recent first) with `next`/`prev` links.
+
+```python
+response = client.search_transactions_by_customer(customer_number)
+response = client.search_transactions_by_receipt(receipt_number)
+response = client.search_transactions_by_order(order_number)
+
+transactions = response["data"]
+```
+
+Pass `page` to fetch a later page, using the number from the `next`/`prev` links:
+
+```python
+response = client.search_transactions_by_customer(customer_number, page=2)
+```
+
+`list_customers()` takes the same `page` argument.
+
 ## Process and capture a pre-authorisation
 
 To process a credit card pre-authorisation using a credit card stored against a customer use `preAuth` as the `transaction_type` along with the customer's PayWay number, amount and currency.

{python_payway-0.0.8 → python_payway-0.0.9}/README.md

@@ -178,6 +178,27 @@ Poll a transaction using the `get_transaction` method.
 transaction, errors = client.get_transaction(transaction.transaction_id)
 ```
 
+## Search transactions
+
+PayWay has no plain `GET /transactions` resource, only three search paths. Each returns a
+paginated list (20 per page, most recent first) with `next`/`prev` links.
+
+```python
+response = client.search_transactions_by_customer(customer_number)
+response = client.search_transactions_by_receipt(receipt_number)
+response = client.search_transactions_by_order(order_number)
+
+transactions = response["data"]
+```
+
+Pass `page` to fetch a later page, using the number from the `next`/`prev` links:
+
+```python
+response = client.search_transactions_by_customer(customer_number, page=2)
+```
+
+`list_customers()` takes the same `page` argument.
+
 ## Process and capture a pre-authorisation
 
 To process a credit card pre-authorisation using a credit card stored against a customer use `preAuth` as the `transaction_type` along with the customer's PayWay number, amount and currency.

{python_payway-0.0.8 → python_payway-0.0.9}/payway/client.py

@@ -15,7 +15,7 @@ from payway.constants import (
     CUSTOMER_URL,
     PAYWAY_ERROR_RESPONSE_CODES,
     RETRYABLE_STATUS_CODES,
-    TOKEN_NO_REDIRECT,
+    TOKEN_URL,
     TRANSACTION_URL,
     VALID_PAYMENT_METHOD_CHOICES,
     PaymentMethod,
@@ -190,7 +190,7 @@ class Client(CustomerRequest, TransactionRequest):
             data["paymentMethod"] = BANK_ACCOUNT_PAYMENT_CHOICE
         logger.info("Sending Create Token request to PayWay.")
         response = self.post_request(
-            TOKEN_NO_REDIRECT,
+            TOKEN_URL,
             data,
             auth=(self.publishable_api_key, ""),
             idempotency_key=idempotency_key,

{python_payway-0.0.8 → python_payway-0.0.9}/payway/constants.py

@@ -10,11 +10,9 @@ class PaymentMethod(StrEnum):
 
 
 PAYWAY_API_URL = "https://api.payway.com.au/rest/v1"
-TOKEN_URL = PAYWAY_API_URL + "/single-use-tokens-redirect"
+TOKEN_URL = PAYWAY_API_URL + "/single-use-tokens"
 TRANSACTION_URL = PAYWAY_API_URL + "/transactions"
 CUSTOMER_URL = PAYWAY_API_URL + "/customers"
-OWN_BANK_ACCOUNTS_URL = PAYWAY_API_URL + "/your-bank-accounts"
-TOKEN_NO_REDIRECT = PAYWAY_API_URL + "/single-use-tokens"
 TRANSACTION_APPROVED = "0"
 
 SUMMARY_CODES = {

{python_payway-0.0.8 → python_payway-0.0.9}/payway/customers.py

@@ -98,10 +98,10 @@ class CustomerRequest:
         )
 
     @json_list("list_customers")
-    def list_customers(self) -> requests.Response:
+    def list_customers(self, page: int | None = None) -> requests.Response:
         """
         List all customers in PayWay
         Returns paginated list of customerNumber, customerName
+        :param page: page number, taken from the `next`/`prev` links of a previous response
         """
-        # TODO: add page numbers
-        return self.session_no_headers.get(CUSTOMER_URL)
+        return self.session_no_headers.get(CUSTOMER_URL, params={"page": page})

python_payway-0.0.9/payway/transactions.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from typing import Any
+
+import requests
+
+from payway.constants import TRANSACTION_URL
+from payway.utils import json_list
+
+
+class TransactionRequest:
+    session = requests.Session()
+    session_no_headers = requests.Session()
+
+    def _search(self, path: str, params: dict[str, Any]) -> requests.Response:
+        return self.session_no_headers.get(f"{TRANSACTION_URL}/{path}", params=params)
+
+    @json_list("search_transactions_by_customer")
+    def search_transactions_by_customer(self, customer_number: int | str, page: int | None = None) -> requests.Response:
+        """
+        Returns a paginated list of transactions for a PayWay customer, most recent first
+        :param customer_number: PayWay customer number
+        :param page: page number, taken from the `next`/`prev` links of a previous response
+        """
+        return self._search("search-customer", {"customerNumber": customer_number, "page": page})
+
+    @json_list("search_transactions_by_receipt")
+    def search_transactions_by_receipt(self, receipt_number: int | str, page: int | None = None) -> requests.Response:
+        """
+        Returns a paginated list of transactions with the given receipt number, most recent first
+        :param receipt_number: PayWay receipt number
+        :param page: page number, taken from the `next`/`prev` links of a previous response
+        """
+        return self._search("search-receipt", {"receiptNumber": receipt_number, "page": page})
+
+    @json_list("search_transactions_by_order")
+    def search_transactions_by_order(self, order_number: str, page: int | None = None) -> requests.Response:
+        """
+        Returns a paginated list of transactions with the given order number, most recent first
+        :param order_number: your order number, supplied when the transaction was created
+        :param page: page number, taken from the `next`/`prev` links of a previous response
+        """
+        return self._search("search-order", {"orderNumber": order_number, "page": page})

{python_payway-0.0.8 → python_payway-0.0.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-payway"
-version = "0.0.8"
+version = "0.0.9"
 description = "Python client for working with Westpac's PayWay REST API"
 authors = [
     { name = "Ben Napper", email = "reppan197@gmail.com" }

{python_payway-0.0.8 → python_payway-0.0.9/python_payway.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-payway
-Version: 0.0.8
+Version: 0.0.9
 Summary: Python client for working with Westpac's PayWay REST API
 Author-email: Ben Napper <reppan197@gmail.com>
 License: MIT
@@ -201,6 +201,27 @@ Poll a transaction using the `get_transaction` method.
 transaction, errors = client.get_transaction(transaction.transaction_id)
 ```
 
+## Search transactions
+
+PayWay has no plain `GET /transactions` resource, only three search paths. Each returns a
+paginated list (20 per page, most recent first) with `next`/`prev` links.
+
+```python
+response = client.search_transactions_by_customer(customer_number)
+response = client.search_transactions_by_receipt(receipt_number)
+response = client.search_transactions_by_order(order_number)
+
+transactions = response["data"]
+```
+
+Pass `page` to fetch a later page, using the number from the `next`/`prev` links:
+
+```python
+response = client.search_transactions_by_customer(customer_number, page=2)
+```
+
+`list_customers()` takes the same `page` argument.
+
 ## Process and capture a pre-authorisation
 
 To process a credit card pre-authorisation using a credit card stored against a customer use `preAuth` as the `transaction_type` along with the customer's PayWay number, amount and currency.

{python_payway-0.0.8 → python_payway-0.0.9}/tests/test_customers.py

@@ -211,6 +211,20 @@ class TestCustomerRequest(unittest.TestCase):
         mock_get.return_value.status_code = 200
         mock_get.return_value.json.return_value = load_json_file("tests/data/customers.json")
         response = self.client.list_customers()
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/customers",
+            params={"page": None},
+        )
         self.assertEqual(response.__class__, dict)
         self.assertIsNotNone(response)
         self.assertIsNotNone(response.get("data"))
+
+    @patch("requests.Session.get")
+    def test_list_customers_with_page(self, mock_get) -> None:
+        mock_get.return_value.status_code = 200
+        mock_get.return_value.json.return_value = load_json_file("tests/data/customers.json")
+        self.client.list_customers(page=3)
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/customers",
+            params={"page": 3},
+        )

python_payway-0.0.9/tests/test_transactions.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import unittest
+from unittest.mock import patch
+
+from payway.client import Client
+from payway.test_utils import load_json_file
+
+
+class TestTransactionRequest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        merchant_id = "TEST"
+        bank_account_id = "0000000A"
+        publishable_api_key = "TPUBLISHABLE-API-KEY"
+        secret_api_key = "TPUBLISHABLE-SECRET"
+
+        cls.client = Client(
+            merchant_id=merchant_id,
+            bank_account_id=bank_account_id,
+            publishable_api_key=publishable_api_key,
+            secret_api_key=secret_api_key,
+        )
+
+    @patch("requests.Session.get")
+    def test_search_transactions_by_customer(self, mock_get) -> None:
+        mock_get.return_value.status_code = 200
+        mock_get.return_value.json.return_value = load_json_file("tests/data/transactions.json")
+        response = self.client.search_transactions_by_customer(1)
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/transactions/search-customer",
+            params={"customerNumber": 1, "page": None},
+        )
+        self.assertIsNotNone(response["data"])
+
+    @patch("requests.Session.get")
+    def test_search_transactions_by_customer_with_page(self, mock_get) -> None:
+        mock_get.return_value.status_code = 200
+        mock_get.return_value.json.return_value = load_json_file("tests/data/transactions.json")
+        self.client.search_transactions_by_customer(1, page=2)
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/transactions/search-customer",
+            params={"customerNumber": 1, "page": 2},
+        )
+
+    @patch("requests.Session.get")
+    def test_search_transactions_by_receipt(self, mock_get) -> None:
+        mock_get.return_value.status_code = 200
+        mock_get.return_value.json.return_value = load_json_file("tests/data/transactions.json")
+        response = self.client.search_transactions_by_receipt("1234567")
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/transactions/search-receipt",
+            params={"receiptNumber": "1234567", "page": None},
+        )
+        self.assertIsNotNone(response["data"])
+
+    @patch("requests.Session.get")
+    def test_search_transactions_by_order(self, mock_get) -> None:
+        mock_get.return_value.status_code = 200
+        mock_get.return_value.json.return_value = load_json_file("tests/data/transactions.json")
+        response = self.client.search_transactions_by_order("ORDER-1")
+        mock_get.assert_called_once_with(
+            "https://api.payway.com.au/rest/v1/transactions/search-order",
+            params={"orderNumber": "ORDER-1", "page": None},
+        )
+        self.assertIsNotNone(response["data"])

python_payway-0.0.8/payway/transactions.py

@@ -1,18 +0,0 @@
-from __future__ import annotations
-
-import requests
-
-from payway.constants import TRANSACTION_URL
-from payway.utils import json_list
-
-
-class TransactionRequest:
-    session = requests.Session()
-    session_no_headers = requests.Session()
-
-    @json_list("search_transactions")
-    def search_transactions(self, query: str) -> requests.Response:
-        """
-        Returns a list of transactions
-        """
-        return self.session_no_headers.get(TRANSACTION_URL + query)

python_payway-0.0.8/tests/test_transactions.py

@@ -1,32 +0,0 @@
-from __future__ import annotations
-
-import unittest
-from unittest.mock import patch
-
-from payway.client import Client
-from payway.test_utils import load_json_file
-
-
-class TestTransactionRequest(unittest.TestCase):
-    @classmethod
-    def setUpClass(cls) -> None:
-        merchant_id = "TEST"
-        bank_account_id = "0000000A"
-        publishable_api_key = "TPUBLISHABLE-API-KEY"
-        secret_api_key = "TPUBLISHABLE-SECRET"
-
-        cls.client = Client(
-            merchant_id=merchant_id,
-            bank_account_id=bank_account_id,
-            publishable_api_key=publishable_api_key,
-            secret_api_key=secret_api_key,
-        )
-
-    @patch("requests.Session.get")
-    def test_search_transactions(self, mock_get) -> None:
-        mock_get.return_value.status_code = 200
-        mock_get.return_value.json.return_value = load_json_file("tests/data/transactions.json")
-        query = "/search-customer?customerNumber=1"
-        response = self.client.search_transactions(query)
-        transactions = response["data"]
-        self.assertIsNotNone(transactions)