connections-sdk 2.0.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

connections_sdk/exceptions.py

@@ -1,15 +1,12 @@
 from connections_sdk.models import ErrorResponse
 
 class TransactionError(Exception):
+    """Raised when request validation fails."""
     error_response: ErrorResponse
     def __init__(self, error_response: 'ErrorResponse'):
         self.error_response = error_response
         super().__init__(str(error_response.error_codes))
 
-class ValidationError(Exception):
-    """Raised when request validation fails."""
-    pass
-
 class ConfigurationError(Exception):
     """Raised when SDK configuration is invalid."""
     pass

connections_sdk/models.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from enum import Enum
-from typing import Optional, Any, Dict, List
+from typing import Optional, Any, Dict, List, Literal
 from datetime import datetime
 
 
@@ -89,7 +89,6 @@ class ErrorType(Enum):
         self.code = code
         self.category = category
 
-
 @dataclass
 class Amount:
     value: int
@@ -121,6 +120,7 @@ class Customer:
     last_name: Optional[str] = None
     email: Optional[str] = None
     address: Optional[Address] = None
+    channel: Optional[Literal['ios', 'android', 'web']] = 'web'
 
 
 @dataclass
@@ -133,8 +133,17 @@ class StatementDescription:
 class ThreeDS:
     eci: Optional[str] = None
     authentication_value: Optional[str] = None
-    xid: Optional[str] = None
     version: Optional[str] = None
+    ds_transaction_id: Optional[str] = None
+    directory_status_code: Optional[str] = None
+    authentication_status_code: Optional[str] = None
+    challenge_cancel_reason_code: Optional[str] = None
+    challenge_preference_code: Optional[str] = None
+    authentication_status_reason_code: Optional[str] = None
+
+    # API aligned fields (preferred)
+    threeds_version: Optional[str] = None
+    authentication_status_reason: Optional[str] = None
 
 
 @dataclass
@@ -175,6 +184,15 @@ class TransactionSource:
     id: str
     provisioned: Optional[ProvisionedSource] = None
 
+@dataclass
+class ResponseCode:
+    category: str
+    code: str
+
+@dataclass
+class BasisTheoryExtras:
+    trace_id: str
+
 
 @dataclass
 class TransactionResponse:
@@ -182,11 +200,12 @@ class TransactionResponse:
     reference: str
     amount: Amount
     status: TransactionStatus
+    response_code: ResponseCode
     source: TransactionSource
     full_provider_response: Dict[str, Any]
     created_at: datetime
     network_transaction_id: Optional[str] = None 
-
+    basis_theory_extras: Optional[BasisTheoryExtras] = None
 
 @dataclass
 class RefundResponse:
@@ -207,4 +226,6 @@ class ErrorCode:
 class ErrorResponse:
     error_codes: List[ErrorCode]
     provider_errors: List[str]
-    full_provider_response: Dict[str, Any]
+    full_provider_response: Dict[str, Any]
+    basis_theory_extras: Optional[BasisTheoryExtras] = None
+    

connections_sdk/providers/adyen.py

@@ -1,6 +1,7 @@
 from typing import Dict, Any, Tuple, Optional, Union, cast
 from datetime import datetime, timezone
 import requests
+from requests.structures import CaseInsensitiveDict
 from deepmerge import always_merger
 from ..models import (
     TransactionRequest,
@@ -22,9 +23,10 @@ from ..models import (
     ErrorCode,
     TransactionResponse,
     TransactionSource,
-    ProvisionedSource
+    ProvisionedSource,
+    ResponseCode
 )
-from ..utils.model_utils import create_transaction_request, validate_required_fields
+from ..utils.model_utils import create_transaction_request, validate_required_fields, _basis_theory_extras
 from ..utils.request_client import RequestClient
 from ..exceptions import TransactionError
 
@@ -121,6 +123,7 @@ class AdyenClient:
             "merchantAccount": self.merchant_account,
             "shopperInteraction": "ContAuth" if request.merchant_initiated else "Ecommerce",
             "storePaymentMethod": request.source.store_with_provider,
+            "channel": request.customer.channel if request.customer else 'web'
         }
 
         if request.metadata:
@@ -206,22 +209,32 @@ class AdyenClient:
 
         # Map 3DS information
         if request.three_ds:
-            three_ds_data: Dict[str, str] = {}
-
-            if request.three_ds.eci:
-                three_ds_data["eci"] = request.three_ds.eci
+            mpi_data: Dict[str, Any] = {}
+            three_ds_2_request_data: Dict[str, Any] = {}
 
             if request.three_ds.authentication_value:
-                three_ds_data["authenticationValue"] = request.three_ds.authentication_value
-
-            if request.three_ds.xid:
-                three_ds_data["xid"] = request.three_ds.xid
+                mpi_data["cavv"] = request.three_ds.authentication_value
+            if request.three_ds.eci:
+                mpi_data["eci"] = request.three_ds.eci
+            if request.three_ds.ds_transaction_id:
+                mpi_data["dsTransID"] = request.three_ds.ds_transaction_id
+            if request.three_ds.directory_status_code:
+                mpi_data["directoryResponse"] = request.three_ds.directory_status_code
+            if request.three_ds.authentication_status_code:
+                mpi_data["authenticationResponse"] = request.three_ds.authentication_status_code
+            if request.three_ds.threeds_version or request.three_ds.version: # threeds_version from API, fallback to version
+                mpi_data["threeDSVersion"] = request.three_ds.threeds_version or request.three_ds.version
+            if request.three_ds.challenge_cancel_reason_code:
+                mpi_data["challengeCancel"] = request.three_ds.challenge_cancel_reason_code
+            
+            if mpi_data:
+                payload["mpiData"] = mpi_data
 
-            if request.three_ds.version:
-                three_ds_data["threeDSVersion"] = request.three_ds.version
+            if request.three_ds.challenge_preference_code:
+                three_ds_2_request_data["threeDSRequestorChallengeInd"] = request.three_ds.challenge_preference_code
 
-            if three_ds_data:
-                payload["additionalData"] = {"threeDSecure": three_ds_data}
+            if three_ds_2_request_data:
+                payload["threeDS2RequestData"] = three_ds_2_request_data
 
         # Override/merge any provider properties if specified
         if request.override_provider_properties:
@@ -229,25 +242,30 @@ class AdyenClient:
 
         return payload
 
-    def _transform_adyen_response(self, response_data: Dict[str, Any], request: TransactionRequest) -> TransactionResponse:
+    def _transform_adyen_response(self, response_data: Dict[str, Any], request: TransactionRequest, headers: CaseInsensitiveDict) -> TransactionResponse:
         """Transform Adyen response to our standardized format."""
         transaction_response = TransactionResponse(
             id=str(response_data.get("pspReference")),
             reference=str(response_data.get("merchantReference")),
             amount=Amount(
-                value=int(response_data.get("amount", {}).get("value")),
-                currency=str(response_data.get("amount", {}).get("currency"))
+                value=int(response_data.get("amount", {}).get("value", request.amount.value)),
+                currency=str(response_data.get("amount", {}).get("currency", request.amount.currency))
             ),
             status=TransactionStatus(
                 code=self._get_status_code(response_data.get("resultCode")),
                 provider_code=str(response_data.get("resultCode"))
             ),
+            response_code=ResponseCode(
+                category=ERROR_CODE_MAPPING.get(str(response_data.get("refusalReasonCode")), ErrorType.OTHER).category,
+                code=ERROR_CODE_MAPPING.get(str(response_data.get("refusalReasonCode")), ErrorType.OTHER).code
+            ),
             source=TransactionSource(
                 type=request.source.type,
                 id=request.source.id,
             ),
             network_transaction_id=str(response_data.get("additionalData", {}).get("networkTxReference")),
             full_provider_response=response_data,
+            basis_theory_extras=_basis_theory_extras(headers),
             created_at=datetime.now(timezone.utc)
         )
 
@@ -261,7 +279,7 @@ class AdyenClient:
 
         return transaction_response
 
-    def _transform_error_response(self, response: requests.Response, response_data: Dict[str, Any]) -> ErrorResponse:
+    def _transform_error_response(self, response: requests.Response, response_data: Dict[str, Any], headers: CaseInsensitiveDict) -> ErrorResponse:
         """Transform error responses to our standardized format.
         
         Args:
@@ -276,10 +294,6 @@ class AdyenClient:
             error_type = ErrorType.INVALID_API_KEY
         elif response.status_code == 403:
             error_type = ErrorType.UNAUTHORIZED
-        # Handle Adyen-specific error codes for declined transactions
-        elif response_data.get("resultCode") in ["Refused", "Error", "Cancelled"]:
-            refusal_code = response_data.get("refusalReasonCode", "")
-            error_type = ERROR_CODE_MAPPING.get(refusal_code, ErrorType.OTHER)
         else:
             error_type = ErrorType.OTHER
 
@@ -291,7 +305,8 @@ class AdyenClient:
                 )
             ],
             provider_errors=[response_data.get("refusalReason") or response_data.get("message", "")],
-            full_provider_response=response_data
+            full_provider_response=response_data,
+            basis_theory_extras=_basis_theory_extras(headers)
         )
 
 
@@ -320,12 +335,8 @@ class AdyenClient:
 
             response_data = response.json()
 
-            # Check if it's an error response (non-200 status code or Adyen error)
-            if not response.ok or response_data.get("resultCode") in ["Refused", "Error", "Cancelled"]:
-                raise TransactionError(self._transform_error_response(response, response_data))
-
             # Transform the successful response to our format
-            return self._transform_adyen_response(response_data, request_data)
+            return self._transform_adyen_response(response_data, request_data, response.headers)
 
         except requests.exceptions.HTTPError as e:
             try:
@@ -333,7 +344,7 @@ class AdyenClient:
             except:
                 error_data = None
 
-            raise TransactionError(self._transform_error_response(e.response, error_data))
+            raise TransactionError(self._transform_error_response(e.response, error_data, e.response.headers))
 
 
     def refund_transaction(self, refund_request: RefundRequest) -> RefundResponse:
@@ -401,5 +412,5 @@ class AdyenClient:
             except:
                 error_data = None
 
-            raise TransactionError(self._transform_error_response(e.response, error_data))
+            raise TransactionError(self._transform_error_response(e.response, error_data, e.response.headers))
 

connections_sdk/providers/checkout.py

@@ -5,7 +5,7 @@ import requests
 import os
 import json
 from json.decoder import JSONDecodeError
-
+from requests.structures import CaseInsensitiveDict
 from ..models import (
     TransactionRequest,
     Amount,
@@ -26,10 +26,11 @@ from ..models import (
     ErrorCode,
     TransactionResponse,
     TransactionSource,
-    ProvisionedSource
+    ProvisionedSource,
+    ResponseCode
 )
 from connections_sdk.exceptions import TransactionError
-from ..utils.model_utils import create_transaction_request, validate_required_fields
+from ..utils.model_utils import create_transaction_request, validate_required_fields, _basis_theory_extras
 from ..utils.request_client import RequestClient
 
 
@@ -169,6 +170,183 @@ ERROR_CODE_MAPPING = {
     "refund_authorization_declined": ErrorType.REFUND_DECLINED
 }
 
+# Mapping of Checkout.com numerical response codes to our error types
+CHECKOUT_NUMERICAL_CODE_MAPPING = {
+    # 20xxx Series - Generally Soft Declines / Informational
+    "20001": ErrorType.REFERRAL,  # Refer to card issuer
+    "20002": ErrorType.REFERRAL,  # Refer to card issuer - Special conditions
+    "20003": ErrorType.CONFIGURATION_ERROR,  # Invalid merchant or service provider
+    "20004": ErrorType.BLOCKED_CARD,  # Card should be captured
+    "20005": ErrorType.REFUSED,  # Declined - Do not honour
+    "20006": ErrorType.OTHER,  # Error / Invalid request parameters
+    "20009": ErrorType.OTHER,  # Request in progress (treating as a final decline state if listed as error)
+    "20012": ErrorType.OTHER,  # Invalid transaction
+    "20013": ErrorType.INVALID_AMOUNT,  # Invalid value/amount
+    "20014": ErrorType.INVALID_CARD,  # Invalid account number (no such number)
+    "20015": ErrorType.NOT_SUPPORTED, # Transaction cannot be processed through debit network
+    "20016": ErrorType.RESTRICTED_CARD,  # Card not initialised
+    "20017": ErrorType.PAYMENT_CANCELLED_BY_CONSUMER,  # Customer cancellation
+    "20018": ErrorType.OTHER, # Customer dispute (more of a post-transaction event, but if it's an error code at payment time)
+    "20019": ErrorType.PAYMENT_CANCELLED, # Re-enter transaction Transaction has expired
+    "20020": ErrorType.OTHER,  # Invalid response
+    "20021": ErrorType.OTHER,  # No action taken (unable to back out prior transaction)
+    "20022": ErrorType.ACQUIRER_ERROR,  # Suspected malfunction
+    "20023": ErrorType.OTHER,  # Unacceptable transaction fee
+    "20024": ErrorType.NOT_SUPPORTED, # File update not supported by the receiver
+    "20025": ErrorType.OTHER, # Unable to locate record on file Account number is missing from the inquiry
+    "20026": ErrorType.OTHER, # Duplicate file update record
+    "20027": ErrorType.OTHER, # File update field edit error
+    "20028": ErrorType.OTHER, # File is temporarily unavailable
+    "20029": ErrorType.OTHER, # File update not successful
+    "20030": ErrorType.OTHER,  # Format error
+    "20031": ErrorType.NOT_SUPPORTED,  # Bank not supported by Switch
+    "20032": ErrorType.OTHER, # Completed partially (typically a success state, but if listed as error)
+    "20033": ErrorType.OTHER, # Previous scheme transaction ID invalid
+    "20038": ErrorType.PIN_TRIES_EXCEEDED,  # Allowable PIN tries exceeded
+    "20039": ErrorType.INVALID_CARD,  # No credit account
+    "20040": ErrorType.NOT_SUPPORTED,  # Requested function not supported
+    "20042": ErrorType.INVALID_AMOUNT, # No universal value/amount
+    "20044": ErrorType.INVALID_CARD, # No investment account
+    "20045": ErrorType.NOT_SUPPORTED, # The Issuer does not support fallback transactions of hybrid-card
+    "20046": ErrorType.BANK_ERROR,  # Bank decline
+    "20051": ErrorType.INSUFFICENT_FUNDS,  # Insufficient funds
+    "20052": ErrorType.INVALID_CARD,  # No current (checking) account
+    "20053": ErrorType.INVALID_CARD,  # No savings account
+    "20054": ErrorType.EXPIRED_CARD,  # Expired card
+    "20055": ErrorType.INVALID_PIN,  # Incorrect PIN PIN validation not possible
+    "20056": ErrorType.INVALID_CARD,  # No card record
+    "20057": ErrorType.NOT_SUPPORTED,  # Transaction not permitted to cardholder
+    "20058": ErrorType.NOT_SUPPORTED,  # Transaction not permitted to terminal
+    "20059": ErrorType.FRAUD,  # Suspected fraud
+    "20060": ErrorType.REFERRAL,  # Card acceptor contact acquirer
+    "20061": ErrorType.INSUFFICENT_FUNDS,  # Activity amount limit exceeded
+    "20062": ErrorType.RESTRICTED_CARD,  # Restricted card
+    "20063": ErrorType.FRAUD,  # Security violation
+    "20064": ErrorType.OTHER, # Transaction does not fulfil AML requirement
+    "20065": ErrorType.INSUFFICENT_FUNDS,  # Exceeds Withdrawal Frequency Limit
+    "20066": ErrorType.REFERRAL,  # Card acceptor call acquirer security
+    "20067": ErrorType.BLOCKED_CARD,  # Hard capture - Pick up card at ATM
+    "20068": ErrorType.ACQUIRER_ERROR,  # Response received too late / Timeout
+    "20072": ErrorType.RESTRICTED_CARD, # Account not yet activated
+    "20075": ErrorType.PIN_TRIES_EXCEEDED,  # Allowable PIN-entry tries exceeded
+    "20078": ErrorType.BLOCKED_CARD,  # Blocked at first use
+    "20081": ErrorType.NOT_SUPPORTED, # Card is local use only
+    "20082": ErrorType.CVC_INVALID,  # No security model / Negative CAM, dCVV, iCVV, or CVV results
+    "20083": ErrorType.INVALID_CARD, # No accounts
+    "20084": ErrorType.OTHER, # No PBF
+    "20085": ErrorType.OTHER, # PBF update error
+    "20086": ErrorType.ACQUIRER_ERROR,  # ATM malfunction Invalid authorization type
+    "20087": ErrorType.INVALID_CARD,  # Bad track data (invalid CVV and/or expiry date)
+    "20088": ErrorType.OTHER, # Unable to dispense/process
+    "20089": ErrorType.OTHER, # Administration error
+    "20090": ErrorType.ACQUIRER_ERROR,  # Cut-off in progress
+    "20091": ErrorType.BANK_ERROR,  # Issuer unavailable or switch is inoperative
+    "20092": ErrorType.ACQUIRER_ERROR,  # Destination cannot be found for routing
+    "20093": ErrorType.NOT_SUPPORTED,  # Transaction cannot be completed; violation of law
+    "20094": ErrorType.OTHER,  # Duplicate transmission / invoice
+    "20095": ErrorType.OTHER,  # Reconcile error
+    "20096": ErrorType.ACQUIRER_ERROR,  # System malfunction
+    "20097": ErrorType.OTHER, # Reconciliation totals reset
+    "20098": ErrorType.OTHER, # MAC error
+    "20099": ErrorType.OTHER,  # Other / Unidentified responses
+    "20197": ErrorType.OTHER,  # Catch-all for many sub-errors like CVV2 failure, transaction not supported. Mapping to OTHER due to its composite nature.
+    "20100": ErrorType.INVALID_CARD,  # Invalid expiry date format
+    "20101": ErrorType.INVALID_SOURCE_TOKEN, # No Account / No Customer (Token is incorrect or invalid)
+    "20102": ErrorType.CONFIGURATION_ERROR,  # Invalid merchant / wallet ID
+    "20103": ErrorType.NOT_SUPPORTED,  # Card type / payment method not supported
+    "20104": ErrorType.OTHER,  # Gateway reject - Invalid transaction
+    "20105": ErrorType.OTHER,  # Gateway reject - Violation
+    "20106": ErrorType.NOT_SUPPORTED,  # Unsupported currency
+    "20107": ErrorType.OTHER,  # Billing address is missing (Could be AVS_DECLINE if validation fails, but often a data validation before submission)
+    "20108": ErrorType.REFUSED, # Declined - Updated cardholder available
+    "20109": ErrorType.OTHER,  # Transaction already reversed (voided) Capture is larger than initial authorized value
+    "20110": ErrorType.OTHER, # Authorization completed (Not an error, but if returned in error context)
+    "20111": ErrorType.OTHER,  # Transaction already reversed
+    "20112": ErrorType.CONFIGURATION_ERROR,  # Merchant not Mastercard SecureCode enabled
+    "20113": ErrorType.OTHER, # Invalid property
+    "20114": ErrorType.INVALID_SOURCE_TOKEN,  # Token is incorrect
+    "20115": ErrorType.OTHER, # Missing / Invalid lifetime
+    "20116": ErrorType.OTHER, # Invalid encoding
+    "20117": ErrorType.CONFIGURATION_ERROR,  # Invalid API version
+    "20118": ErrorType.OTHER,  # Transaction pending
+    "20119": ErrorType.OTHER, # Invalid batch data and/or batch data is missing
+    "20120": ErrorType.OTHER, # Invalid customer/user
+    "20121": ErrorType.OTHER, # Transaction limit for merchant/terminal exceeded
+    "20122": ErrorType.NOT_SUPPORTED, # Mastercard installments not supported
+    "20123": ErrorType.OTHER, # Missing basic data: zip, addr, member
+    "20124": ErrorType.CVC_INVALID,  # Missing CVV value, required for ecommerce transaction
+    "20150": ErrorType.AUTHENTICATION_FAILURE,  # Card not 3D Secure (3DS) enabled
+    "20151": ErrorType.AUTHENTICATION_FAILURE,  # Cardholder failed 3DS authentication
+    "20152": ErrorType.AUTHENTICATION_FAILURE,  # Initial 3DS transaction not completed within 15 minutes
+    "20153": ErrorType.AUTHENTICATION_FAILURE,  # 3DS system malfunction
+    "20154": ErrorType.AUTHENTICATION_REQUIRED,  # 3DS authentication required
+    "20155": ErrorType.AUTHENTICATION_FAILURE, # 3DS authentication service provided invalid authentication result
+    "20156": ErrorType.NOT_SUPPORTED, # Requested function not supported by the acquirer
+    "20157": ErrorType.CONFIGURATION_ERROR, # Invalid merchant configurations - Contact Support
+    "20158": ErrorType.OTHER, # Refund validity period has expired
+    "20159": ErrorType.AUTHENTICATION_FAILURE, # ACS Malfunction
+    "20179": ErrorType.INVALID_CARD, # Lifecycle (Occurs when transaction has invalid card data)
+    "20182": ErrorType.NOT_SUPPORTED, # Policy (Occurs when a transaction does not comply with card policy)
+    "20183": ErrorType.FRAUD, # Security (Occurs when a transaction is suspected to be fraudulent)
+    "20193": ErrorType.OTHER, # Invalid country code
+
+    # 30xxx Series - Hard Declines
+    "30004": ErrorType.BLOCKED_CARD,  # Pick up card (No fraud)
+    "30007": ErrorType.BLOCKED_CARD,  # Pick up card - Special conditions
+    "30015": ErrorType.INVALID_CARD,  # No such issuer
+    "30016": ErrorType.NOT_SUPPORTED, # Issuer does not allow online gambling payout
+    "30017": ErrorType.NOT_SUPPORTED,  # Issuer does not allow original credit transaction
+    "30018": ErrorType.NOT_SUPPORTED, # Issuer does not allow money transfer payout
+    "30019": ErrorType.NOT_SUPPORTED, # Issuer does not allow non-money transfer payout
+    "30020": ErrorType.INVALID_AMOUNT,  # Invalid amount
+    "30021": ErrorType.INSUFFICENT_FUNDS,  # Total amount limit reached
+    "30022": ErrorType.OTHER,  # Total transaction count limit reached
+    "30033": ErrorType.EXPIRED_CARD,  # Expired card - Pick up
+    "30034": ErrorType.FRAUD,  # Suspected fraud - Pick up
+    "30035": ErrorType.REFERRAL,  # Contact acquirer - Pick up
+    "30036": ErrorType.RESTRICTED_CARD,  # Restricted card - Pick up
+    "30037": ErrorType.REFERRAL,  # Call acquirer security - Pick up
+    "30038": ErrorType.PIN_TRIES_EXCEEDED,  # Allowable PIN tries exceeded - Pick up
+    "30041": ErrorType.BLOCKED_CARD,  # Lost card - Pick up
+    "30043": ErrorType.FRAUD,  # Stolen card - Pick up
+    "30044": ErrorType.NOT_SUPPORTED, # Transaction rejected - AMLD5
+    "30045": ErrorType.NOT_SUPPORTED, # Invalid payout fund transfer type
+    "30046": ErrorType.INVALID_CARD,  # Closed account
+
+    # 4xxxx Series - Risk Responses
+    "40101": ErrorType.FRAUD,  # Risk blocked transaction
+    "40201": ErrorType.FRAUD,  # Gateway reject - card number blocklist
+    "40202": ErrorType.FRAUD,  # Gateway reject - IP address blocklist
+    "40203": ErrorType.FRAUD,  # Gateway reject - email blocklist
+    "40204": ErrorType.FRAUD,  # Gateway reject - phone number blocklist
+    "40205": ErrorType.FRAUD,  # Gateway Reject - BIN number blocklist
+    "41101": ErrorType.FRAUD,  # Risk Blocked Transaction (Client-level rule)
+    "41201": ErrorType.FRAUD,  # Decline list - Card number (Client-level)
+    "41202": ErrorType.FRAUD,  # Decline list - BIN (Client-level)
+    "41203": ErrorType.FRAUD,  # Decline list - Email address (Client-level)
+    "41204": ErrorType.FRAUD,  # Decline list - Phone (Client-level)
+    "41205": ErrorType.FRAUD,  # Decline list - Payment IP (Client-level) - using client as first seen
+    "41206": ErrorType.FRAUD,  # Decline list - Email domain (Client-level)
+    "41301": ErrorType.FRAUD,  # Fraud score exceeds threshold (Client-level)
+    "42101": ErrorType.FRAUD,  # Risk Blocked Transaction (Entity-level rule)
+    "42201": ErrorType.FRAUD,  # Decline list - Card number (Client-level)
+    "42202": ErrorType.FRAUD,  # Decline list - BIN (Client-level)
+    "42203": ErrorType.FRAUD,  # Decline list - Email address (Client-level)
+    "42204": ErrorType.FRAUD,  # Decline list - Phone (Client-level)
+    "42206": ErrorType.FRAUD,  # Decline list - Email domain (Client-level)
+    "42301": ErrorType.FRAUD,  # Fraud score exceeds threshold
+    "43101": ErrorType.FRAUD,  # Potential fraud risk
+    "43102": ErrorType.FRAUD,  # Risk blocked transaction – {Rule group name} (Checkout.com-level)
+    "43201": ErrorType.FRAUD,  # Decline list - Card number (Checkout.com-level)
+    "43202": ErrorType.FRAUD,  # Decline list - BIN (Checkout.com-level)
+    "43203": ErrorType.FRAUD,  # Decline list - Email address (Checkout.com-level)
+    "43204": ErrorType.FRAUD,  # Decline list - Phone (Checkout.com-level)
+    "43205": ErrorType.FRAUD,  # Decline list - Payment IP (Checkout.com-level)
+    "43206": ErrorType.FRAUD,  # Decline list - Email domain (Checkout.com-level)
+    "43301": ErrorType.FRAUD,  # Fraud score exceeds threshold (Checkout.com-level)
+    "44301": ErrorType.AUTHENTICATION_REQUIRED,  # 3DS authentication required
+}
+
 
 class CheckoutClient:
     def __init__(self, private_key: str, processing_channel: str, is_test: bool, bt_api_key: str):
@@ -268,15 +446,34 @@ class CheckoutClient:
 
         # Add 3DS information if provided
         if request.three_ds:
-            three_ds_data: Dict[str, str] = {}
-            if request.three_ds.eci:
-                three_ds_data["eci"] = request.three_ds.eci
+            three_ds_data: Dict[str, Any] = {
+                "enabled": True
+            }
+
             if request.three_ds.authentication_value:
                 three_ds_data["cryptogram"] = request.three_ds.authentication_value
-            if request.three_ds.xid:
-                three_ds_data["xid"] = request.three_ds.xid
-            if request.three_ds.version:
-                three_ds_data["version"] = request.three_ds.version
+            if request.three_ds.eci:
+                three_ds_data["eci"] = request.three_ds.eci
+            if request.three_ds.threeds_version or request.three_ds.version: # threeds_version from API, fallback to version
+                three_ds_data["version"] = request.three_ds.threeds_version or request.three_ds.version
+            if request.three_ds.ds_transaction_id: # ds_transaction_id in BT, xid in Checkout
+                three_ds_data["xid"] = request.three_ds.ds_transaction_id
+            if request.three_ds.authentication_status_code:
+                three_ds_data["status"] = request.three_ds.authentication_status_code
+            if request.three_ds.authentication_status_reason_code:
+                three_ds_data["status_reason_code"] = request.three_ds.authentication_status_reason_code
+            
+            if request.three_ds.challenge_preference_code:
+                challenge_indicator_mapping = {
+                    "no-preference": "no_preference",
+                    "no-challenge": "no_challenge_requested",
+                    "challenge-requested": "challenge_requested",
+                    "challenge-mandated": "challenge_requested_mandate"
+                }
+                checkout_challenge_indicator = challenge_indicator_mapping.get(request.three_ds.challenge_preference_code)
+                if checkout_challenge_indicator: # Only add if a valid mapping exists
+                    three_ds_data["challenge_indicator"] = checkout_challenge_indicator
+
             payload["3ds"] = three_ds_data
 
         # Override/merge any provider properties if specified
@@ -285,19 +482,34 @@ class CheckoutClient:
 
         return payload
 
-    def _transform_checkout_response(self, response_data: Dict[str, Any], request: TransactionRequest) -> TransactionResponse:
+    def _transform_checkout_response(self, response_data: Dict[str, Any], request: TransactionRequest, headers: CaseInsensitiveDict, error_data: Optional[Dict[str, Any]] = None) -> TransactionResponse:
         """Transform Checkout.com response to our standardized format."""
+        response_code = ResponseCode(
+            category=CHECKOUT_NUMERICAL_CODE_MAPPING.get(str(response_data.get("response_code")), ErrorType.OTHER).category,
+            code=CHECKOUT_NUMERICAL_CODE_MAPPING.get(str(response_data.get("response_code")), ErrorType.OTHER).code
+        )
+
+        if error_data and isinstance(error_data, dict):
+            error_codes = error_data.get("error_codes", [])
+            if error_codes and len(error_codes) > 0:
+                first_error = str(error_codes[0])
+                response_code = ResponseCode(
+                    category=ERROR_CODE_MAPPING.get(first_error, ErrorType.OTHER).category,
+                    code=ERROR_CODE_MAPPING.get(first_error, ErrorType.OTHER).code
+                )
+
         return TransactionResponse(
             id=str(response_data.get("id")),
             reference=str(response_data.get("reference")),
             amount=Amount(
-                value=int(str(response_data.get("amount"))),
-                currency=str(response_data.get("currency"))
+                value=int(str(response_data.get("amount", request.amount.value))),
+                currency=str(response_data.get("currency", request.amount.currency))
             ),
             status=TransactionStatus(
-                code=self._get_status_code(response_data.get("status")),
-                provider_code=str(response_data.get("status"))
+                code=self._get_status_code(response_data.get("status", TransactionStatusCode.DECLINED)),
+                provider_code=str(response_data.get("status", ""))
             ),
+            response_code=response_code,
             source=TransactionSource(
                 type=request.source.type,
                 id=request.source.id,
@@ -306,8 +518,9 @@ class CheckoutClient:
                 ) if response_data.get("source", {}).get("id") else None
             ),
             full_provider_response=response_data,
+            basis_theory_extras=_basis_theory_extras(headers),
             created_at=datetime.fromisoformat(response_data["processed_on"].split(".")[0] + "+00:00") if response_data.get("processed_on") else datetime.now(timezone.utc),
-            network_transaction_id=str(response_data.get("processing", {}).get("acquirer_transaction_id"))
+            network_transaction_id=response_data.get("scheme_id")
         )
 
     def _get_error_code(self, error: ErrorType) -> Dict[str, Any]:
@@ -322,14 +535,17 @@ class CheckoutClient:
             code=error.code
         )
 
-    def _transform_error_response_object(self, response, error_data=None) -> ErrorResponse:
+    def _transform_error_response_object(self, response, error_data=None, headers=None) -> ErrorResponse:
         """Transform error response from Checkout.com to SDK format."""
         error_codes = []
+        provider_errors = error_data.get('error_codes', []) if error_data else []
         
         if response.status_code == 401:
             error_codes.append(self._get_error_code_object(ErrorType.INVALID_API_KEY))
         elif response.status_code == 403:
             error_codes.append(self._get_error_code_object(ErrorType.UNAUTHORIZED))
+        elif response.status_code == 404:
+            error_codes.append(self._get_error_code_object(ErrorType.REFUND_FAILED))
         elif error_data is not None:
             for error_code in error_data.get('error_codes', []):
                 mapped_error = ERROR_CODE_MAPPING.get(error_code, ErrorType.OTHER)
@@ -342,7 +558,8 @@ class CheckoutClient:
         
         return ErrorResponse(
             error_codes=error_codes,
-            provider_errors=error_data.get('error_codes', []) if error_data else [],
+            provider_errors=provider_errors,
+            basis_theory_extras=_basis_theory_extras(headers),
             full_provider_response=error_data
         )
 
@@ -352,7 +569,7 @@ class CheckoutClient:
         validate_required_fields(request_data)
         # Transform request to Checkout.com format
         payload = self._transform_to_checkout_payload(request_data)
-        
+
         # Set up common headers
         headers = {
             "Authorization": f"Bearer {self.api_key}",
@@ -368,6 +585,11 @@ class CheckoutClient:
                 data=payload,
                 use_bt_proxy=request_data.source.type != SourceType.PROCESSOR_TOKEN
             )
+
+            response_data = response.json()
+            
+            print(f"Response data: {response_data}")
+            
         except requests.exceptions.HTTPError as e:
             # Check if this is a BT error
             if hasattr(e, 'bt_error_response'):
@@ -375,13 +597,16 @@ class CheckoutClient:
             
             try:
                 error_data = e.response.json()
+
+                if "card_expired" in error_data.get("error_codes", []) or "card_disabled" in error_data.get("error_codes", []):
+                    return self._transform_checkout_response(error_data, request_data, e.response.headers, error_data)
             except:
                 error_data = None
 
-            raise TransactionError(self._transform_error_response_object(e.response, error_data))
+            raise TransactionError(self._transform_error_response_object(e.response, error_data, e.response.headers))
 
         # Transform response to SDK format
-        return self._transform_checkout_response(response.json(), request_data)
+        return self._transform_checkout_response(response.json(), request_data, response.headers)
 
     def refund_transaction(self, refund_request: RefundRequest) -> RefundResponse:
         """
@@ -416,7 +641,7 @@ class CheckoutClient:
             )
 
             response_data = response.json()
-            
+
             # Transform the response to a standardized format
             return RefundResponse(
                 id=response_data.get('action_id'),
@@ -434,5 +659,4 @@ class CheckoutClient:
             except:
                 error_data = None
 
-            raise TransactionError(self._transform_error_response_object(e.response, error_data))
-            
+            raise TransactionError(self._transform_error_response_object(e.response, error_data, e.response.headers))

connections_sdk/utils/model_utils.py

@@ -1,4 +1,5 @@
 from typing import Dict, Any, Optional
+from requests.structures import CaseInsensitiveDict
 from ..models import (
     TransactionRequest,
     Amount,
@@ -8,10 +9,29 @@ from ..models import (
     Address,
     StatementDescription,
     ThreeDS,
-    RecurringType
+    RecurringType,
+    ErrorType,
+    ErrorResponse,
+    ErrorCode,
+    BasisTheoryExtras
 )
-from ..exceptions import ValidationError
+from ..exceptions import TransactionError
 
+def _error_code(error_type: ErrorType) -> ErrorCode:
+    """
+    Validate the amount in a transaction request.
+    """
+    return ErrorCode(
+        category=error_type.category,
+        code=error_type.code
+    )
+
+def _basis_theory_extras(headers: Optional[CaseInsensitiveDict]) -> Optional[BasisTheoryExtras]:
+    if headers and "bt-trace-id" in headers:
+        return BasisTheoryExtras(
+            trace_id=headers.get("bt-trace-id", "")
+        )
+    return None
 
 def validate_required_fields(data: TransactionRequest) -> None:
     """
@@ -21,12 +41,20 @@ def validate_required_fields(data: TransactionRequest) -> None:
         data: TransactionRequest containing transaction request data
         
     Raises:
-        ValidationError: If required fields are missing
+        TransactionError: If required fields are missing
     """
     if data.amount is None or data.amount.value is None:
-        raise ValidationError("amount.value is required")
+        raise TransactionError(ErrorResponse(
+            error_codes=[_error_code(ErrorType.INVALID_AMOUNT)],
+            provider_errors=[],
+            full_provider_response={}
+        ))
     if not data.source or not data.source.type or not data.source.id:
-        raise ValidationError("source.type and source.id are required")
+        raise TransactionError(ErrorResponse(
+            error_codes=[_error_code(ErrorType.INVALID_SOURCE_TOKEN)],
+            provider_errors=[],
+            full_provider_response={}
+        ))
 
 
 def create_transaction_request(data: Dict[str, Any]) -> TransactionRequest:
@@ -40,7 +68,7 @@ def create_transaction_request(data: Dict[str, Any]) -> TransactionRequest:
         TransactionRequest: A fully populated TransactionRequest object
         
     Raises:
-        ValidationError: If required fields are missing
+        TransactionError: If required fields are missing
     """
     return TransactionRequest(
         amount=Amount(

connections_sdk/utils/request_client.py

@@ -1,4 +1,4 @@
-from typing import Dict, Any, Optional, Union, List, cast
+from typing import Dict, Any, Optional, List
 import requests
 from requests.models import Response
 from ..models import ErrorType, ErrorCode, ErrorResponse
@@ -41,7 +41,7 @@ class RequestClient:
                 ErrorCode(
                     category=error_type.category,
                     code=error_type.code
-                )
+                )   
             ],
             provider_errors=provider_errors,
             full_provider_response=response_data

{connections_sdk-2.0.0.dist-info → connections_sdk-3.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: connections_sdk
-Version: 2.0.0
+Version: 3.0.0
 Summary: A Python SDK for payment processing
 Author: Basis Theory
 Author-email: support@basistheory.com

connections_sdk-3.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+connections_sdk/__init__.py,sha256=IYYzlDWAgIeJs_1Ly2_SNsUYtMjGexysfY3Q9-L1Pn8,174
+connections_sdk/client.py,sha256=FkZq68S_syvaJTVRSVPtpA4FwsybRdC9FivRi2SOkoI,3165
+connections_sdk/config.py,sha256=OPH-J11ecQYP17ubtIXuB_VVuso3t-Ym9V8f5j-G1Xk,398
+connections_sdk/exceptions.py,sha256=AuLet9gpV6OmQrKLO9ozgyrWw1KCPuUxV8Own7gTEmk,761
+connections_sdk/models.py,sha256=L_AntoEFsD9I3TeAi8j-h7HGQK1mNXsHnwZOT5vn7iI,7414
+connections_sdk/providers/adyen.py,sha256=j2-FRLsqGJFNYMxq9-8hy1R5zLzmYJ_h-uHwPtcAk9Y,18509
+connections_sdk/providers/checkout.py,sha256=j3YwmpFWt66Zbb9j-pO8vyxYxV_cupbrw0aixvBdKy4,35153
+connections_sdk/utils/__init__.py,sha256=iKwqW2egmbc_LO0oQoNLiP5-RBXUd9OpMW6sdEVB_Fs,153
+connections_sdk/utils/model_utils.py,sha256=FB6Cf-dMFr52gi-F6yMEAPJU413Sjv_8zx3IUNBI-Q8,4015
+connections_sdk/utils/request_client.py,sha256=M9eqEpRVoIFUMS51jGJ-C2R1L9_NWw3v3saAq31hVoI,3251
+connections_sdk-3.0.0.dist-info/LICENSE,sha256=OJSDpWNs9gHwRBdHonZIkQ2-rUpFMxn0V8xxjfz4UQQ,11342
+connections_sdk-3.0.0.dist-info/METADATA,sha256=CwqdNMn8KCXHaSRk-10MFWcqMxtnE2dT1MyGIbkyQZI,2821
+connections_sdk-3.0.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+connections_sdk-3.0.0.dist-info/RECORD,,

connections_sdk-2.0.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-connections_sdk/__init__.py,sha256=IYYzlDWAgIeJs_1Ly2_SNsUYtMjGexysfY3Q9-L1Pn8,174
-connections_sdk/client.py,sha256=FkZq68S_syvaJTVRSVPtpA4FwsybRdC9FivRi2SOkoI,3165
-connections_sdk/config.py,sha256=OPH-J11ecQYP17ubtIXuB_VVuso3t-Ym9V8f5j-G1Xk,398
-connections_sdk/exceptions.py,sha256=3L3X1OCp7EIPg5l4NPfcEUrPPahfEft-qnZ5QfxXR0k,805
-connections_sdk/models.py,sha256=slAgi-v9qZjWNGvHrJc8myXcN-v1X2lP5gXFjj6fUCQ,6650
-connections_sdk/providers/adyen.py,sha256=6iOyy_7Sh1cZTaV9Lu4MHaazDcL0aUtgYnYluIAMIk4,17458
-connections_sdk/providers/checkout.py,sha256=2hTWkZwnMazlQn4MpICoQ5GZDfGOEhrjYp5QknbuCG4,19543
-connections_sdk/utils/__init__.py,sha256=iKwqW2egmbc_LO0oQoNLiP5-RBXUd9OpMW6sdEVB_Fs,153
-connections_sdk/utils/model_utils.py,sha256=B1lIam4Ctajnhi1H9eB7hpM4IVbemHgpHzBVruoPKcU,3159
-connections_sdk/utils/request_client.py,sha256=zbCGoJajAQ9RUNUb5x5edSaqdxJxPhoedAwUBT0S3ek,3261
-connections_sdk-2.0.0.dist-info/LICENSE,sha256=OJSDpWNs9gHwRBdHonZIkQ2-rUpFMxn0V8xxjfz4UQQ,11342
-connections_sdk-2.0.0.dist-info/METADATA,sha256=bcoDDC_r3AhbyIKend4Zylkw7Pup1RvALske8rGKIN4,2821
-connections_sdk-2.0.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-connections_sdk-2.0.0.dist-info/RECORD,,