Python SDK

pip install mcards-sdk

import os
from mcards_sdk import McardsSdk

# HMAC authentication
client = McardsSdk(
    api_key=os.environ["MCARDS_API_KEY"],
    api_secret=os.environ["MCARDS_API_SECRET"],
    base_url="https://api.mcards.com",  # optional
)

# All requests are automatically signed with HMAC-SHA256
profile = client.partner.get_profile()
print(f"Partner: {profile.data['name']}")

# Context manager (auto-closes HTTP client)
with McardsSdk(api_key="...", api_secret="...") as client:
    wallets = client.wallets.list()

# OAuth2 Bearer token authentication
client = McardsSdk()

# 1. Exchange credentials for token
token = client.oauth.create_token(
    client_id="your-client-id",
    client_secret="your-client-secret",
    scope="partner:read wallets:read cards:read",
)

# 2. Set the Bearer token
client.set_bearer_token(token.data["access_token"])

# 3. Make authenticated requests
wallets = client.wallets.list()

# All methods return an ApiResponse object
class ApiResponse:
    data: dict | list | None  # Parsed JSON
    status: int               # HTTP status code
    headers: dict             # Response headers
    error: str | None         # Error message if not ok
    ok: bool                  # True if status < 400

# Check-based error handling
result = client.cards.get("card-uuid")
if not result.ok:
    print(f"Error {result.status}: {result.error}")

# Exception-based error handling
from mcards_sdk.exceptions import McardsSdkError

try:
    result = client.cards.get("card-uuid")
    result.raise_for_error()
except McardsSdkError as e:
    print(f"API error: {e} (status={e.status})")