Merge pull request #8 from WilliamOtieno/develop

Develop

Author: WilliamOtieno

python_flutterwave/charge/__init__.py

@@ -2,4 +2,3 @@
 from .card import *
 from .mobile import *
 from .validation import *
-

python_flutterwave/decorators.py

@@ -5,6 +5,7 @@
 
 token = os.environ.get("FW_SECRET_KEY")
 
+
 def require_token(func):
     def wrapper(*args, **kwargs):
         if token == "" or token is None:

python_flutterwave/exceptions.py

@@ -3,8 +3,6 @@ class FlutterwaveAPIException(Exception):
 
 
 class TokenException(FlutterwaveAPIException):
-
     def __init__(self, token, message):
         super().__init__(f"Token Error: {message}")
         self.token = token
-

python_flutterwave/objects.py

@@ -0,0 +1,37 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class RetryStrategy:
+    """
+    This object defines retries for failed tokenization attempts.
+    :param retry_interval: int
+    :param retry_amount_variable: int
+    :param retry_attempt_variable: int
+    :param last_retry_attempt: int = 10
+    """
+
+    retry_interval: int
+    retry_amount_variable: int
+    retry_attempt_variable: int
+    last_retry_attempt: int = 10
+
+
+@dataclass
+class ChargeData:
+    """
+    Object containing your charge data
+    :param currency: str
+    :param token: str
+    :param country: str
+    :param amount: int
+    :param email: str
+    :param tx_ref: str
+    """
+
+    currency: str
+    token: str
+    country: str
+    amount: int
+    email: str
+    tx_ref: str

python_flutterwave/tokenization/__init__.py

@@ -0,0 +1 @@
+from .tokenized_charge import *

python_flutterwave/tokenization/tokenized_charge.py

@@ -0,0 +1,148 @@
+import os
+import requests
+import json
+from dataclasses import asdict
+from python_flutterwave.decorators import handle_api_exceptions
+from python_flutterwave.objects import ChargeData, RetryStrategy
+
+auth_token = os.environ.get("FW_SECRET_KEY")
+
+
+@handle_api_exceptions
+def initiate_tokenized_charge(
+    amount: int, email: str, tx_ref: str, currency: str, token: str
+) -> dict:
+    """
+    This endpoint helps you tokenize a customer's card
+    :param token: str
+    :param tx_ref: str
+    :param amount: int
+    :param email: str
+    :param currency: str
+    :return: dict
+    """
+
+    payload = json.dumps(
+        {
+            "tx_ref": f"{tx_ref}",
+            "amount": f"{amount}",
+            "email": f"{email}",
+            "token": f"{token}",
+            "currency": f"{currency}",
+        }
+    )
+    headers = {
+        "Authorization": f"Bearer {auth_token}",
+        "Content-Type": "application/json",
+    }
+
+    response = requests.post(
+        url="https://api.flutterwave.com/v3/tokenized-charges",
+        headers=headers,
+        data=payload,
+    )
+
+    return dict(response.json())
+
+
+@handle_api_exceptions
+def initiate_bulk_tokenized_charges(
+    retry_strategy: RetryStrategy, bulk_data: list[ChargeData]
+) -> dict:
+    """
+    Tokenize multiple cards at once
+    :param retry_strategy: RetryStrategy
+    :param bulk_data: list[ChargeData]
+    :return: dict
+    """
+
+    payload = json.dumps(
+        {
+            "retry_strategy": asdict(retry_strategy),
+            "bulk_data": [asdict(i) for i in bulk_data],
+        }
+    )
+    headers = {
+        "Authorization": f"Bearer {auth_token}",
+        "Content-Type": "application/json",
+    }
+
+    response = requests.post(
+        url="https://api.flutterwave.com/v3/bulk-tokenized-charges",
+        headers=headers,
+        data=payload,
+    )
+
+    return dict(response.json())
+
+
+@handle_api_exceptions
+def fetch_bulk_tokenized_charges(bulk_id: int):
+    """
+    This endpoint allows you to get bulk tokenized charges transactions
+    :param bulk_id: int
+    """
+
+    headers = {
+        "Authorization": f"Bearer {auth_token}",
+        "Content-Type": "application/json",
+    }
+
+    response = requests.get(
+        url=f"https://api.flutterwave.com/v3/bulk-tokenized-charges/{bulk_id}/transactions",
+        headers=headers,
+    )
+
+    return dict(response.json())
+
+
+@handle_api_exceptions
+def fetch_bulk_tokenized_charges_status(bulk_id: int):
+    """
+    This endpoint allows you to query the status of a bulk tokenized charge
+    :param bulk_id: int
+    """
+
+    headers = {
+        "Authorization": f"Bearer {auth_token}",
+        "Content-Type": "application/json",
+    }
+
+    response = requests.get(
+        url=f"https://api.flutterwave.com/v3/bulk-tokenized-charges/{bulk_id}",
+        headers=headers,
+    )
+
+    return dict(response.json())
+
+
+@handle_api_exceptions
+def update_card_token(email: str, full_name: str, phone_number: str, token: str):
+    """
+    This endpoints allow developers update the details tied to a customer's card token.
+    :param email: str
+    :param phone_number: str
+    :param full_name: str
+    :param token: str
+    """
+
+    payload = json.dumps(
+        {
+            "email": f"{email}",
+            "full_name": f"{full_name}",
+            "phone_number": f"{phone_number}",
+        }
+    )
+
+    headers = {
+        "Authorization": f"Bearer {auth_token}",
+        "Content-Type": "application/json",
+    }
+
+    response = requests.get(
+        url=f"https://api.flutterwave.com/v3/tokens/{token}",
+        headers=headers,
+        data=payload,
+    )
+
+    return dict(response.json())

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = python-flutterwave
-version = 1.0.0
+version = 1.0.1
 author = William Otieno
 author_email = jimmywilliamotieno@gmail.com
 description = Python Wrapper for interacting with the Flutterwave Payments API