feat: Airwallex 发卡管理后台完整实现
- 后端: FastAPI + SQLAlchemy + SQLite, JWT认证, 代理支持的AirwallexClient - 前端: React 18 + Vite + Ant Design 5, 中文界面 - 功能: 卡片管理, 持卡人管理, 交易记录, API令牌, 系统设置, 审计日志 - 第三方API: X-API-Key认证, 权限控制 - Docker部署: docker-compose编排前后端
This commit is contained in:
zqq61
192
airwallex-sdk/airwallex/api/issuing_transaction.py
Normal file
192
airwallex-sdk/airwallex/api/issuing_transaction.py
Normal file
@@ -0,0 +1,192 @@
|
||||
"""
|
||||
Airwallex Issuing Transaction API.
|
||||
"""
|
||||
from typing import Dict, Any, List, Optional, Type, TypeVar, Union, cast
|
||||
from datetime import datetime
|
||||
from ..models.issuing_transaction import Transaction
|
||||
from .base import AirwallexAPIBase
|
||||
|
||||
T = TypeVar("T", bound=Transaction)
|
||||
|
||||
|
||||
class IssuingTransaction(AirwallexAPIBase[Transaction]):
|
||||
"""
|
||||
Operations for Airwallex issuing transactions.
|
||||
|
||||
Transactions represent payments processed against cards.
|
||||
"""
|
||||
endpoint = "issuing/transactions"
|
||||
model_class = cast(Type[Transaction], Transaction)
|
||||
|
||||
def list_with_filters(
|
||||
self,
|
||||
billing_currency: Optional[str] = None,
|
||||
card_id: Optional[str] = None,
|
||||
digital_wallet_token_id: Optional[str] = None,
|
||||
from_created_at: Optional[Union[str, datetime]] = None,
|
||||
lifecycle_id: Optional[str] = None,
|
||||
page_num: int = 0,
|
||||
page_size: int = 10,
|
||||
retrieval_ref: Optional[str] = None,
|
||||
to_created_at: Optional[Union[str, datetime]] = None,
|
||||
transaction_type: Optional[str] = None
|
||||
) -> List[Transaction]:
|
||||
"""
|
||||
List transactions with filtering options.
|
||||
|
||||
Args:
|
||||
billing_currency: Currency in which transition was billed (3-letter ISO-4217 code)
|
||||
card_id: Unique Identifier for card
|
||||
digital_wallet_token_id: Unique Identifier for digital token
|
||||
from_created_at: Start of Transaction Date in ISO8601 format (inclusive)
|
||||
lifecycle_id: Unique Identifier for lifecycle
|
||||
page_num: Page number, starts from 0
|
||||
page_size: Number of results per page
|
||||
retrieval_ref: Retrieval reference number
|
||||
to_created_at: End of Transaction Date in ISO8601 format (inclusive)
|
||||
transaction_type: Transaction type (AUTHORIZATION, CLEARING, REFUND, REVERSAL, ORIGINAL_CREDIT)
|
||||
|
||||
Returns:
|
||||
List[Transaction]: List of matching transactions
|
||||
"""
|
||||
params = {
|
||||
"page_num": page_num,
|
||||
"page_size": page_size
|
||||
}
|
||||
|
||||
if billing_currency:
|
||||
params["billing_currency"] = billing_currency
|
||||
|
||||
if card_id:
|
||||
params["card_id"] = card_id
|
||||
|
||||
if digital_wallet_token_id:
|
||||
params["digital_wallet_token_id"] = digital_wallet_token_id
|
||||
|
||||
if from_created_at:
|
||||
params["from_created_at"] = from_created_at
|
||||
|
||||
if lifecycle_id:
|
||||
params["lifecycle_id"] = lifecycle_id
|
||||
|
||||
if retrieval_ref:
|
||||
params["retrieval_ref"] = retrieval_ref
|
||||
|
||||
if to_created_at:
|
||||
params["to_created_at"] = to_created_at
|
||||
|
||||
if transaction_type:
|
||||
params["transaction_type"] = transaction_type
|
||||
|
||||
if not str(self.client.__class__.__name__).startswith('Async'):
|
||||
response = self.client._request("GET", self._build_url(), params=params)
|
||||
data = response.json()
|
||||
return [self.model_class.from_api_response(item) for item in data.get("items", [])]
|
||||
else:
|
||||
raise ValueError("Use list_with_filters_async for async clients")
|
||||
|
||||
async def list_with_filters_async(
|
||||
self,
|
||||
billing_currency: Optional[str] = None,
|
||||
card_id: Optional[str] = None,
|
||||
digital_wallet_token_id: Optional[str] = None,
|
||||
from_created_at: Optional[Union[str, datetime]] = None,
|
||||
lifecycle_id: Optional[str] = None,
|
||||
page_num: int = 0,
|
||||
page_size: int = 10,
|
||||
retrieval_ref: Optional[str] = None,
|
||||
to_created_at: Optional[Union[str, datetime]] = None,
|
||||
transaction_type: Optional[str] = None
|
||||
) -> List[Transaction]:
|
||||
"""
|
||||
List transactions with filtering options asynchronously.
|
||||
|
||||
Args:
|
||||
billing_currency: Currency in which transition was billed (3-letter ISO-4217 code)
|
||||
card_id: Unique Identifier for card
|
||||
digital_wallet_token_id: Unique Identifier for digital token
|
||||
from_created_at: Start of Transaction Date in ISO8601 format (inclusive)
|
||||
lifecycle_id: Unique Identifier for lifecycle
|
||||
page_num: Page number, starts from 0
|
||||
page_size: Number of results per page
|
||||
retrieval_ref: Retrieval reference number
|
||||
to_created_at: End of Transaction Date in ISO8601 format (inclusive)
|
||||
transaction_type: Transaction type (AUTHORIZATION, CLEARING, REFUND, REVERSAL, ORIGINAL_CREDIT)
|
||||
|
||||
Returns:
|
||||
List[Transaction]: List of matching transactions
|
||||
"""
|
||||
params = {
|
||||
"page_num": page_num,
|
||||
"page_size": page_size
|
||||
}
|
||||
|
||||
if billing_currency:
|
||||
params["billing_currency"] = billing_currency
|
||||
|
||||
if card_id:
|
||||
params["card_id"] = card_id
|
||||
|
||||
if digital_wallet_token_id:
|
||||
params["digital_wallet_token_id"] = digital_wallet_token_id
|
||||
|
||||
if from_created_at:
|
||||
params["from_created_at"] = from_created_at
|
||||
|
||||
if lifecycle_id:
|
||||
params["lifecycle_id"] = lifecycle_id
|
||||
|
||||
if retrieval_ref:
|
||||
params["retrieval_ref"] = retrieval_ref
|
||||
|
||||
if to_created_at:
|
||||
params["to_created_at"] = to_created_at
|
||||
|
||||
if transaction_type:
|
||||
params["transaction_type"] = transaction_type
|
||||
|
||||
if str(self.client.__class__.__name__).startswith('Async'):
|
||||
response = await self.client._request("GET", self._build_url(), params=params)
|
||||
data = response.json()
|
||||
return [self.model_class.from_api_response(item) for item in data.get("items", [])]
|
||||
else:
|
||||
raise ValueError("Use list_with_filters for sync clients")
|
||||
|
||||
def paginate(self, **params: Any) -> List[Transaction]:
|
||||
"""
|
||||
Fetch all pages of transactions.
|
||||
|
||||
Args:
|
||||
**params: Filter parameters to pass to the API
|
||||
|
||||
Returns:
|
||||
List[Transaction]: All transactions matching the filters
|
||||
"""
|
||||
if str(self.client.__class__.__name__).startswith('Async'):
|
||||
raise ValueError("This method requires a sync client.")
|
||||
|
||||
all_items: List[Dict[str, Any]] = []
|
||||
page_num = params.get("page_num", 0)
|
||||
page_size = params.get("page_size", 10)
|
||||
|
||||
while True:
|
||||
params["page_num"] = page_num
|
||||
params["page_size"] = page_size
|
||||
|
||||
response = self.client._request("GET", self._build_url(), params=params)
|
||||
data = response.json()
|
||||
|
||||
items = data.get("items", [])
|
||||
has_more = data.get("has_more", False)
|
||||
|
||||
if not items:
|
||||
break
|
||||
|
||||
all_items.extend(items)
|
||||
|
||||
if not has_more:
|
||||
break
|
||||
|
||||
page_num += 1
|
||||
|
||||
return [self.model_class.from_api_response(item) for item in all_items]
|
||||
Reference in New Issue
Block a user