airwallex-sdk 0.1.0__py3-none-any.whl

airwallex/models/invoice.py

@@ -0,0 +1,102 @@
+"""
+Models for the Airwallex Invoice API.
+"""
+from typing import Optional, List, Dict, Any, Union
+from datetime import datetime
+from pydantic import Field, validator
+from .base import AirwallexModel
+
+
+class RecurringBilling(AirwallexModel):
+    """Model for recurring billing information."""
+    period: int = Field(..., description="The length of the billing cycle")
+    period_unit: str = Field(..., description="The unit of the billing cycle, e.g., 'MONTH', 'YEAR'")
+
+
+class PriceTier(AirwallexModel):
+    """Model for price tier information."""
+    amount: float = Field(..., description="The price for this tier")
+    upper_bound: Optional[float] = Field(None, description="The upper bound of this tier")
+
+
+class Price(AirwallexModel):
+    """Model for price information."""
+    id: str = Field(..., description="Unique price ID")
+    name: str = Field(..., description="Price name")
+    description: Optional[str] = Field(None, description="Price description")
+    active: bool = Field(..., description="Whether this price is active")
+    currency: str = Field(..., description="Currency code (ISO 4217)")
+    product_id: str = Field(..., description="ID of the associated product")
+    pricing_model: str = Field(..., description="Pricing model type (e.g., 'tiered')")
+    recurring: Optional[RecurringBilling] = Field(None, description="Recurring billing details")
+    tiers: Optional[List[PriceTier]] = Field(None, description="Pricing tiers for tiered pricing")
+    metadata: Optional[Dict[str, str]] = Field(None, description="Additional metadata")
+    request_id: Optional[str] = Field(None, description="Request ID when creating this price")
+
+
+class InvoiceItem(AirwallexModel):
+    """Model for an Airwallex invoice item."""
+    id: str = Field(..., description="Unique invoice item ID")
+    invoice_id: str = Field(..., description="ID of the invoice this item belongs to")
+    amount: float = Field(..., description="Amount for this invoice item")
+    currency: str = Field(..., description="Currency code (ISO 4217)")
+    period_start_at: datetime = Field(..., description="Billing period start (inclusive)")
+    period_end_at: datetime = Field(..., description="Billing period end (exclusive)")
+    price: Price = Field(..., description="Price details")
+    quantity: Optional[float] = Field(None, description="Product quantity")
+
+
+class Invoice(AirwallexModel):
+    """Model for an Airwallex invoice."""
+    resource_name: str = "invoices"
+    
+    id: str = Field(..., description="Unique invoice ID")
+    customer_id: str = Field(..., description="ID of the customer who will be charged")
+    subscription_id: Optional[str] = Field(None, description="ID of the subscription which generated this invoice")
+    currency: str = Field(..., description="Currency code (ISO 4217)")
+    total_amount: float = Field(..., description="Total amount of the invoice")
+    status: str = Field(..., description="Invoice status (SENT, PAID, PAYMENT_FAILED)")
+    payment_intent_id: Optional[str] = Field(None, description="ID of the associated payment intent")
+    period_start_at: datetime = Field(..., description="Billing period start (inclusive)")
+    period_end_at: datetime = Field(..., description="Billing period end (exclusive)")
+    created_at: datetime = Field(..., description="Invoice creation timestamp")
+    updated_at: Optional[datetime] = Field(None, description="Invoice last update timestamp")
+    paid_at: Optional[datetime] = Field(None, description="Timestamp when invoice was paid")
+    last_payment_attempt_at: Optional[datetime] = Field(None, description="Timestamp of last payment attempt")
+    next_payment_attempt_at: Optional[datetime] = Field(None, description="Timestamp of next scheduled payment attempt")
+    past_payment_attempt_count: Optional[int] = Field(None, description="Number of payment attempts made so far")
+    remaining_payment_attempt_count: Optional[int] = Field(None, description="Number of remaining payment attempts")
+    items: Optional[List[InvoiceItem]] = Field(None, description="Invoice items")
+    
+    @validator('status')
+    def validate_status(cls, v):
+        """Validate invoice status."""
+        valid_statuses = ['SENT', 'PAID', 'PAYMENT_FAILED']
+        if v not in valid_statuses:
+            raise ValueError(f"Status must be one of {valid_statuses}")
+        return v
+
+
+class InvoicePreviewRequest(AirwallexModel):
+    """Model for invoice preview request."""
+    customer_id: str = Field(..., description="ID of the customer for this invoice")
+    subscription_id: Optional[str] = Field(None, description="ID of the subscription to preview the invoice for")
+    trial_end_at: Optional[datetime] = Field(None, description="End of the trial period if applicable")
+    recurring: Optional[RecurringBilling] = Field(None, description="Recurring billing details")
+    
+    class SubscriptionItem(AirwallexModel):
+        """Model for subscription item in invoice preview."""
+        price_id: str = Field(..., description="ID of the price")
+        quantity: float = Field(1, description="Quantity of the product")
+    
+    items: Optional[List[SubscriptionItem]] = Field(None, description="List of subscription items")
+
+
+class InvoicePreviewResponse(AirwallexModel):
+    """Model for invoice preview response."""
+    customer_id: str = Field(..., description="ID of the customer for this invoice")
+    subscription_id: Optional[str] = Field(None, description="ID of the subscription for this invoice")
+    currency: str = Field(..., description="Currency code (ISO 4217)")
+    total_amount: float = Field(..., description="Total amount of the invoice")
+    created_at: datetime = Field(..., description="Expected invoice creation timestamp")
+    items: List[InvoiceItem] = Field(..., description="Invoice items in the preview")

airwallex/models/issuing_authorization.py

@@ -0,0 +1,41 @@
+"""
+Models for the Airwallex Issuing Authorization API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+from .issuing_common import Merchant, RiskDetails, HasMoreResponse
+
+
+class Authorization(AirwallexModel):
+    """Model for an Airwallex issuing authorization."""
+    resource_name: str = "issuing/authorizations"
+    
+    acquiring_institution_identifier: Optional[str] = Field(None, description="Unique Identifier for acquiring institution")
+    auth_code: Optional[str] = Field(None, description="Authorization Code")
+    billing_amount: float = Field(..., description="Billing Amount")
+    billing_currency: str = Field(..., description="Billing Currency")
+    card_id: str = Field(..., description="Unique Identifier for card")
+    card_nickname: Optional[str] = Field(None, description="The nickname of the card used")
+    client_data: Optional[str] = Field(None, description="Client data stored against the card record")
+    create_time: datetime = Field(..., description="The time this outstanding authorization was created")
+    digital_wallet_token_id: Optional[str] = Field(None, description="Unique Identifier for digital token")
+    expiry_date: Optional[datetime] = Field(None, description="The authorization will expire after this date if not posted")
+    failure_reason: Optional[str] = Field(None, description="The reason why this authorization failed (if status is FAILED)")
+    lifecycle_id: Optional[str] = Field(None, description="A identifier that links multiple related transactions")
+    masked_card_number: Optional[str] = Field(None, description="Masked card number")
+    merchant: Optional[Merchant] = Field(None, description="Merchant details")
+    network_transaction_id: Optional[str] = Field(None, description="The transaction ID from network")
+    retrieval_ref: Optional[str] = Field(None, description="Transaction retrieval reference number")
+    risk_details: Optional[RiskDetails] = Field(None, description="Risk details")
+    status: str = Field(..., description="The status of this authorization")
+    transaction_amount: float = Field(..., description="Transaction amount")
+    transaction_currency: str = Field(..., description="Transaction currency")
+    transaction_id: str = Field(..., description="Unique id for transaction")
+    updated_by_transaction: Optional[str] = Field(None, description="Id of the transaction which updated status of this transaction")
+
+
+class AuthorizationListResponse(HasMoreResponse):
+    """Model for authorization list response."""
+    items: List[Authorization] = Field(..., description="List of authorizations")

airwallex/models/issuing_card.py

@@ -0,0 +1,135 @@
+"""
+Models for the Airwallex Issuing Card API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+from .issuing_common import Address, TransactionUsage, DeliveryDetails, HasMoreResponse
+
+
+class CardVersionInfo(AirwallexModel):
+    """Model for card version information."""
+    card_number: str = Field(..., description="Masked card number")
+    card_status: str = Field(..., description="Current card status")
+    card_version: int = Field(..., description="Card version")
+    created_at: datetime = Field(..., description="Creation time of the card version")
+
+
+class SpendLimit(AirwallexModel):
+    """Model for spend limit."""
+    amount: float = Field(..., description="Limit amount")
+    interval: str = Field(..., description="Limit interval (e.g., 'PER_TRANSACTION')")
+    remaining: Optional[float] = Field(None, description="Remaining limit amount")
+
+
+class CardLimits(AirwallexModel):
+    """Model for card limits."""
+    cash_withdrawal_limits: List[SpendLimit] = Field(..., description="Cash withdrawal limits")
+    currency: str = Field(..., description="Currency of limits")
+    limits: List[SpendLimit] = Field(..., description="Spending limits")
+
+
+class PrimaryContactDetails(AirwallexModel):
+    """Model for primary contact details."""
+    email: Optional[str] = Field(None, description="Email address")
+    name: Optional[str] = Field(None, description="Name")
+    phone_number: Optional[str] = Field(None, description="Phone number")
+
+
+class CardProgram(AirwallexModel):
+    """Model for card program."""
+    id: str = Field(..., description="Program ID")
+    name: str = Field(..., description="Program name")
+
+
+class AuthorizationControls(AirwallexModel):
+    """Model for card authorization controls."""
+    active_from: Optional[datetime] = Field(None, description="Start time for card validity")
+    active_to: Optional[datetime] = Field(None, description="End time for card validity")
+    allowed_currencies: Optional[List[str]] = Field(None, description="Allowed currencies")
+    allowed_merchant_categories: Optional[List[str]] = Field(None, description="Allowed merchant category codes")
+    allowed_transaction_count: Optional[str] = Field(None, description="Allowed transaction count (SINGLE or MULTIPLE)")
+    blocked_transaction_usages: Optional[List[TransactionUsage]] = Field(None, description="Blocked transaction usages")
+    country_limitations: Optional[List[str]] = Field(None, description="Country limitations")
+    spend_limits: Optional[List[SpendLimit]] = Field(None, description="Spend limits")
+
+
+class CardCreateRequest(AirwallexModel):
+    """Model for card creation request."""
+    activate_on_issue: Optional[bool] = Field(None, description="Activate on issue")
+    additional_cardholder_ids: Optional[List[str]] = Field(None, description="Additional cardholder IDs")
+    authorization_controls: AuthorizationControls = Field(..., description="Authorization controls")
+    brand: Optional[str] = Field(None, description="Card brand")
+    cardholder_id: str = Field(..., description="Cardholder ID")
+    client_data: Optional[str] = Field(None, description="Client data")
+    created_by: str = Field(..., description="Full legal name of user requesting new card")
+    form_factor: str = Field(..., description="Form factor (PHYSICAL or VIRTUAL)")
+    funding_source_id: Optional[str] = Field(None, description="Funding source ID")
+    is_personalized: bool = Field(..., description="Whether the card is personalized")
+    metadata: Optional[Dict[str, str]] = Field(None, description="Metadata")
+    nick_name: Optional[str] = Field(None, description="Card nickname")
+    note: Optional[str] = Field(None, description="Note")
+    postal_address: Optional[Address] = Field(None, description="Postal address")
+    program: CardProgram = Field(..., description="Card program")
+    purpose: Optional[str] = Field(None, description="Card purpose")
+    request_id: str = Field(..., description="Request ID")
+
+
+class CardUpdateRequest(AirwallexModel):
+    """Model for card update request."""
+    additional_cardholder_ids: Optional[List[str]] = Field(None, description="Additional cardholder IDs")
+    authorization_controls: Optional[AuthorizationControls] = Field(None, description="Authorization controls")
+    card_status: Optional[str] = Field(None, description="Card status")
+    cardholder_id: Optional[str] = Field(None, description="Cardholder ID")
+    metadata: Optional[Dict[str, str]] = Field(None, description="Metadata")
+    nick_name: Optional[str] = Field(None, description="Card nickname")
+    purpose: Optional[str] = Field(None, description="Card purpose")
+
+
+class Card(AirwallexModel):
+    """Model for an Airwallex issuing card."""
+    resource_name: str = "issuing/cards"
+    
+    activate_on_issue: Optional[bool] = Field(None, description="Activate on issue")
+    additional_cardholder_ids: Optional[List[str]] = Field(None, description="Additional cardholder IDs")
+    all_card_versions: Optional[List[CardVersionInfo]] = Field(None, description="All card versions")
+    authorization_controls: AuthorizationControls = Field(..., description="Authorization controls")
+    brand: str = Field(..., description="Card brand")
+    card_id: str = Field(..., description="Card ID")
+    card_number: str = Field(..., description="Masked card number")
+    card_status: str = Field(..., description="Card status")
+    card_version: int = Field(..., description="Card version")
+    cardholder_id: str = Field(..., description="Cardholder ID")
+    client_data: Optional[str] = Field(None, description="Client data")
+    created_at: datetime = Field(..., description="Creation time")
+    created_by: str = Field(..., description="Created by")
+    delivery_details: Optional[DeliveryDetails] = Field(None, description="Delivery details")
+    form_factor: str = Field(..., description="Form factor")
+    funding_source_id: Optional[str] = Field(None, description="Funding source ID")
+    is_personalized: bool = Field(..., description="Whether the card is personalized")
+    issue_to: str = Field(..., description="Who the card is issued to")
+    metadata: Optional[Dict[str, str]] = Field(None, description="Metadata")
+    name_on_card: Optional[str] = Field(None, description="Name on card")
+    nick_name: Optional[str] = Field(None, description="Nickname")
+    note: Optional[str] = Field(None, description="Note")
+    postal_address: Optional[Address] = Field(None, description="Postal address")
+    primary_contact_details: Optional[PrimaryContactDetails] = Field(None, description="Primary contact details")
+    program: CardProgram = Field(..., description="Card program")
+    purpose: Optional[str] = Field(None, description="Purpose")
+    request_id: str = Field(..., description="Request ID")
+    updated_at: datetime = Field(..., description="Last update time")
+
+
+class CardDetails(AirwallexModel):
+    """Model for sensitive card details."""
+    card_number: str = Field(..., description="Full card number")
+    cvv: str = Field(..., description="Card verification value")
+    expiry_month: int = Field(..., description="Expiry month")
+    expiry_year: int = Field(..., description="Expiry year")
+    name_on_card: str = Field(..., description="Name on card")
+
+
+class CardListResponse(HasMoreResponse):
+    """Model for card list response."""
+    items: List[Card] = Field(..., description="List of cards")

airwallex/models/issuing_cardholder.py

@@ -0,0 +1,52 @@
+"""
+Models for the Airwallex Issuing Cardholder API.
+"""
+from typing import Optional, List, Dict, Any, Literal
+from pydantic import Field, EmailStr
+from .base import AirwallexModel
+from .issuing_common import Address, Name, Employer, HasMoreResponse
+
+
+class Individual(AirwallexModel):
+    """Model for individual cardholder details."""
+    address: Address = Field(..., description="Address of the cardholder")
+    cardholder_agreement_terms_consent_obtained: Optional[str] = Field(None, description="Whether consent was obtained")
+    date_of_birth: str = Field(..., description="Date of birth in YYYY-MM-DD format")
+    employers: Optional[List[Employer]] = Field(None, description="Employers")
+    express_consent_obtained: Optional[str] = Field(None, description="Whether express consent was obtained")
+    name: Name = Field(..., description="Name of the cardholder")
+
+
+class CardholderCreateRequest(AirwallexModel):
+    """Model for cardholder creation request."""
+    email: EmailStr = Field(..., description="Email address of the cardholder")
+    individual: Individual = Field(..., description="Details about the cardholder")
+    mobile_number: Optional[str] = Field(None, description="Mobile number of the cardholder")
+    postal_address: Optional[Address] = Field(None, description="Postal address of the cardholder")
+    type: str = Field(..., description="The type of cardholder (INDIVIDUAL or DELEGATE)")
+
+
+class CardholderUpdateRequest(AirwallexModel):
+    """Model for cardholder update request."""
+    individual: Optional[Individual] = Field(None, description="Details about the cardholder")
+    mobile_number: Optional[str] = Field(None, description="Mobile number of the cardholder")
+    postal_address: Optional[Address] = Field(None, description="Postal address of the cardholder")
+    type: Optional[str] = Field(None, description="The type of cardholder (INDIVIDUAL or DELEGATE)")
+
+
+class Cardholder(AirwallexModel):
+    """Model for an Airwallex cardholder."""
+    resource_name: str = "issuing/cardholders"
+    
+    cardholder_id: str = Field(..., description="Unique Identifier for cardholder")
+    email: EmailStr = Field(..., description="Email address of the cardholder")
+    individual: Optional[Individual] = Field(None, description="Details about the cardholder")
+    mobile_number: Optional[str] = Field(None, description="The mobile number of the cardholder")
+    postal_address: Optional[Address] = Field(None, description="Postal address for the cardholder")
+    status: str = Field(..., description="The status of the cardholder (PENDING, READY, DISABLED, INCOMPLETE)")
+    type: str = Field(..., description="The type of cardholder (INDIVIDUAL or DELEGATE)")
+
+
+class CardholderListResponse(HasMoreResponse):
+    """Model for cardholder list response."""
+    items: List[Cardholder] = Field(..., description="List of cardholders")

airwallex/models/issuing_common.py

@@ -0,0 +1,83 @@
+"""
+Common models for the Airwallex Issuing API.
+"""
+from typing import Optional, List, Dict, Any, Union
+from datetime import datetime
+from pydantic import Field, EmailStr
+from .base import AirwallexModel
+
+
+class Address(AirwallexModel):
+    """Model for address information."""
+    city: str = Field(..., description="City")
+    country: str = Field(..., description="Country code (ISO 3166-1 alpha-2)")
+    line1: str = Field(..., description="Street address line 1")
+    line2: Optional[str] = Field(None, description="Street address line 2")
+    postcode: Optional[str] = Field(None, description="Postal or ZIP code")
+    state: Optional[str] = Field(None, description="State or province")
+
+
+class Name(AirwallexModel):
+    """Model for person name."""
+    first_name: str = Field(..., description="First name")
+    last_name: str = Field(..., description="Last name")
+    middle_name: Optional[str] = Field(None, description="Middle name")
+    title: Optional[str] = Field(None, description="Title (Mr, Mrs, etc.)")
+
+
+class BusinessIdentifier(AirwallexModel):
+    """Model for business identifier."""
+    country_code: str = Field(..., description="Country code (ISO 3166-1 alpha-2)")
+    number: str = Field(..., description="Identifier number")
+    type: str = Field(..., description="Identifier type (e.g., 'BRN')")
+
+
+class Employer(AirwallexModel):
+    """Model for employer information."""
+    business_name: str = Field(..., description="Business name")
+    business_identifiers: Optional[List[BusinessIdentifier]] = Field(None, description="Business identifiers")
+
+
+class Merchant(AirwallexModel):
+    """Model for merchant information."""
+    category_code: Optional[str] = Field(None, description="Merchant category code")
+    city: Optional[str] = Field(None, description="Merchant city")
+    country: Optional[str] = Field(None, description="Merchant country")
+    identifier: Optional[str] = Field(None, description="Merchant identifier")
+    name: Optional[str] = Field(None, description="Merchant name")
+    postcode: Optional[str] = Field(None, description="Merchant postal code")
+    state: Optional[str] = Field(None, description="Merchant state")
+
+
+class RiskDetails(AirwallexModel):
+    """Model for risk details."""
+    risk_actions_performed: Optional[List[str]] = Field(None, description="Risk actions performed")
+    risk_factors: Optional[List[str]] = Field(None, description="Risk factors identified")
+    three_dsecure_outcome: Optional[str] = Field(None, description="3D Secure outcome")
+
+
+class DeviceInformation(AirwallexModel):
+    """Model for device information."""
+    device_id: Optional[str] = Field(None, description="Device identifier")
+    device_type: Optional[str] = Field(None, description="Device type")
+
+
+class TransactionUsage(AirwallexModel):
+    """Model for transaction usage."""
+    transaction_scope: str = Field(..., description="Transaction scope (e.g., 'MAGSTRIPE')")
+    usage_scope: str = Field(..., description="Usage scope (e.g., 'INTERNATIONAL')")
+
+
+class DeliveryDetails(AirwallexModel):
+    """Model for delivery details."""
+    delivery_method: Optional[str] = Field(None, description="Delivery method")
+    tracking_number: Optional[str] = Field(None, description="Tracking number")
+    courier: Optional[str] = Field(None, description="Courier")
+    status: Optional[str] = Field(None, description="Delivery status")
+    estimated_delivery_date: Optional[datetime] = Field(None, description="Estimated delivery date")
+
+
+class HasMoreResponse(AirwallexModel):
+    """Base model for paginated responses with has_more field."""
+    has_more: bool = Field(..., description="Whether there are more items available")
+    items: List[Any] = Field(..., description="List of items")

airwallex/models/issuing_config.py

@@ -0,0 +1,62 @@
+"""
+Models for the Airwallex Issuing Config API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+from .issuing_common import TransactionUsage
+
+
+class RemoteAuthSettings(AirwallexModel):
+    """Model for remote auth settings."""
+    created_at: Optional[datetime] = Field(None, description="Creation timestamp")
+    default_action: Optional[str] = Field(None, description="Default action when remote auth fails")
+    enabled: Optional[bool] = Field(None, description="Whether remote auth is enabled")
+    shared_secret: Optional[str] = Field(None, description="Shared secret key")
+    updated_at: Optional[datetime] = Field(None, description="Last update timestamp")
+    url: Optional[str] = Field(None, description="Remote auth endpoint URL")
+
+
+class RemoteCallMethod(AirwallexModel):
+    """Model for remote call method."""
+    name: str = Field(..., description="Method name")
+    path: str = Field(..., description="Method path")
+
+
+class RemoteCallConfig(AirwallexModel):
+    """Model for remote call configuration."""
+    methods: List[RemoteCallMethod] = Field(..., description="Available methods")
+    shared_secret: Optional[str] = Field(None, description="Shared secret key")
+    url: str = Field(..., description="Base URL")
+
+
+class RemoteProvisioningConfig(AirwallexModel):
+    """Model for remote provisioning configuration."""
+    activated: Optional[bool] = Field(None, description="Whether remote provisioning is activated")
+    shared_secret: Optional[str] = Field(None, description="Shared secret key")
+    url: Optional[str] = Field(None, description="Remote provisioning endpoint URL")
+
+
+class SpendingLimitSettings(AirwallexModel):
+    """Model for spending limit settings."""
+    default_limits: Optional[Dict[str, Dict[str, float]]] = Field(None, description="Default limits")
+    maximum_limits: Optional[Dict[str, Dict[str, float]]] = Field(None, description="Maximum limits")
+
+
+class IssuingConfig(AirwallexModel):
+    """Model for issuing configuration."""
+    resource_name: str = "issuing/config"
+    
+    blocked_transaction_usages: Optional[List[TransactionUsage]] = Field(None, description="Blocked transaction usages")
+    remote_auth_settings: Optional[RemoteAuthSettings] = Field(None, description="Remote authorization settings")
+    remote_call_config: Optional[RemoteCallConfig] = Field(None, description="Remote call configuration")
+    remote_provisioning_config: Optional[RemoteProvisioningConfig] = Field(None, description="Remote provisioning configuration")
+    spending_limit_settings: Optional[SpendingLimitSettings] = Field(None, description="Spending limit settings")
+
+
+class IssuingConfigUpdateRequest(AirwallexModel):
+    """Model for issuing config update request."""
+    remote_auth: Optional[RemoteAuthSettings] = Field(None, description="Remote authorization configuration")
+    remote_call_config: Optional[RemoteCallConfig] = Field(None, description="Remote call configuration")
+    remote_provisioning_config: Optional[RemoteProvisioningConfig] = Field(None, description="Remote provisioning configuration")

airwallex/models/issuing_digital_wallet_token.py

@@ -0,0 +1,38 @@
+"""
+Models for the Airwallex Issuing Digital Wallet Token API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+from .issuing_common import DeviceInformation, HasMoreResponse
+
+
+class RiskInformation(AirwallexModel):
+    """Model for token risk information."""
+    wallet_provider_account_score: Optional[str] = Field(None, description="Wallet provider account score")
+    wallet_provider_device_score: Optional[str] = Field(None, description="Wallet provider device score")
+
+
+class DigitalWalletToken(AirwallexModel):
+    """Model for an Airwallex digital wallet token."""
+    resource_name: str = "issuing/digital_wallet_tokens"
+    
+    card_id: str = Field(..., description="Unique identifier for card associated with the token")
+    cardholder_id: str = Field(..., description="Unique identifier for cardholder associated with the token")
+    create_time: datetime = Field(..., description="The time this token was created")
+    device_information: Optional[DeviceInformation] = Field(None, description="Device information")
+    expiry_month: int = Field(..., description="Token expiry month")
+    expiry_year: int = Field(..., description="Token expiry year")
+    masked_card_number: str = Field(..., description="Masked card number")
+    pan_reference_id: str = Field(..., description="Unique identifier for the tokenization of this card")
+    risk_information: Optional[RiskInformation] = Field(None, description="Risk information")
+    token_id: str = Field(..., description="Unique Identifier for token")
+    token_reference_id: str = Field(..., description="Unique identifier of the digital wallet token within the card network")
+    token_status: str = Field(..., description="Status of the token")
+    token_type: str = Field(..., description="The type of this token")
+
+
+class DigitalWalletTokenListResponse(HasMoreResponse):
+    """Model for digital wallet token list response."""
+    items: List[DigitalWalletToken] = Field(..., description="List of digital wallet tokens")

airwallex/models/issuing_transaction.py

@@ -0,0 +1,42 @@
+"""
+Models for the Airwallex Issuing Transaction API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+from .issuing_common import Merchant, RiskDetails, HasMoreResponse
+
+
+class Transaction(AirwallexModel):
+    """Model for an Airwallex issuing transaction."""
+    resource_name: str = "issuing/transactions"
+    
+    acquiring_institution_identifier: Optional[str] = Field(None, description="Unique Identifier for acquiring institution")
+    auth_code: Optional[str] = Field(None, description="Authorization Code")
+    billing_amount: float = Field(..., description="Billing amount")
+    billing_currency: str = Field(..., description="Billing Currency")
+    card_id: str = Field(..., description="Unique Identifier for card")
+    card_nickname: Optional[str] = Field(None, description="The nickname of the card used")
+    client_data: Optional[str] = Field(None, description="Client data stored against the card record")
+    digital_wallet_token_id: Optional[str] = Field(None, description="Unique Identifier for digital token")
+    failure_reason: Optional[str] = Field(None, description="The reason why this transaction failed")
+    lifecycle_id: Optional[str] = Field(None, description="Lifecycle ID")
+    masked_card_number: str = Field(..., description="Masked card number")
+    matched_authorizations: Optional[List[str]] = Field(None, description="Matched authorization IDs")
+    merchant: Optional[Merchant] = Field(None, description="Merchant details")
+    network_transaction_id: Optional[str] = Field(None, description="Network transaction ID")
+    posted_date: Optional[datetime] = Field(None, description="Posted date")
+    retrieval_ref: Optional[str] = Field(None, description="Retrieval reference number")
+    risk_details: Optional[RiskDetails] = Field(None, description="Risk details")
+    status: str = Field(..., description="Transaction status")
+    transaction_amount: float = Field(..., description="Transaction amount")
+    transaction_currency: str = Field(..., description="Transaction currency")
+    transaction_date: datetime = Field(..., description="Transaction date")
+    transaction_id: str = Field(..., description="Transaction ID")
+    transaction_type: str = Field(..., description="Transaction type")
+
+
+class TransactionListResponse(HasMoreResponse):
+    """Model for transaction list response."""
+    items: List[Transaction] = Field(..., description="List of transactions")

airwallex/models/issuing_transaction_dispute.py

@@ -0,0 +1,59 @@
+"""
+Models for the Airwallex Issuing Transaction Dispute API.
+"""
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from pydantic import Field
+from .base import AirwallexModel
+
+
+class DisputeUpdateHistory(AirwallexModel):
+    """Model for dispute update history."""
+    evidence_files: Optional[List[str]] = Field(None, description="Evidence files")
+    note: Optional[str] = Field(None, description="Note")
+    updated_at: datetime = Field(..., description="Update timestamp")
+    updated_by: str = Field(..., description="Entity that performed the update")
+
+
+class TransactionDisputeCreateRequest(AirwallexModel):
+    """Model for transaction dispute creation request."""
+    amount: Optional[float] = Field(None, description="The amount to be disputed")
+    evidence_files: Optional[List[str]] = Field(None, description="Evidence file IDs")
+    notes: Optional[str] = Field(None, description="Explanation for the dispute")
+    reason: str = Field(..., description="The reason for raising the dispute")
+    reference: Optional[str] = Field(None, description="Internal reference")
+    transaction_id: str = Field(..., description="The transaction ID to dispute")
+
+
+class TransactionDisputeUpdateRequest(AirwallexModel):
+    """Model for transaction dispute update request."""
+    amount: Optional[float] = Field(None, description="The disputed amount")
+    evidence_files: Optional[List[str]] = Field(None, description="Evidence file IDs")
+    notes: Optional[str] = Field(None, description="Explanation for the dispute")
+    reason: Optional[str] = Field(None, description="The reason for raising the dispute")
+    request_id: str = Field(..., description="A unique request ID")
+
+
+class TransactionDispute(AirwallexModel):
+    """Model for an Airwallex transaction dispute."""
+    resource_name: str = "issuing/transaction_disputes"
+    
+    amount: float = Field(..., description="Dispute amount")
+    created_at: datetime = Field(..., description="Creation timestamp")
+    detailed_status: Optional[str] = Field(None, description="Detailed status")
+    id: str = Field(..., description="Unique identifier")
+    notes: Optional[str] = Field(None, description="Notes")
+    reason: str = Field(..., description="Dispute reason")
+    reference: Optional[str] = Field(None, description="Internal reference")
+    status: str = Field(..., description="Status")
+    transaction_id: str = Field(..., description="Transaction ID")
+    update_history: List[DisputeUpdateHistory] = Field(..., description="Update history")
+    updated_at: datetime = Field(..., description="Last update timestamp")
+    updated_by: str = Field(..., description="Last updated by")
+
+
+class TransactionDisputeListResponse(AirwallexModel):
+    """Model for transaction dispute list response."""
+    items: List[TransactionDispute] = Field(..., description="List of transaction disputes")
+    page_after: Optional[str] = Field(None, description="Page bookmark for next page")
+    page_before: Optional[str] = Field(None, description="Page bookmark for previous page")