from aice_payment import PaymentClient, CheckoutRequest

client = PaymentClient(base_url="https://pay.example.com", api_key="your-api-key")

# Create a checkout
response = client.create_checkout(
    CheckoutRequest(
        order_ref="ORD-001",
        gateway="bkash",
        amount_minor=50000,  # 500.00 BDT
        currency="BDT",
        customer={"name": "Customer Name"},
        return_urls={"success": "https://your-app.example/success"},
    )
)
print(response.redirect_url)  # redirect the customer here

# Retrieve a transaction
tx = client.get_transaction(response.transaction_id)
if tx.is_succeeded():
    print("Payment successful")

# Refund
tx = client.refund(response.transaction_id)

from aice_payment import (
    PaymentError,
    UnauthorizedError,
    NotFoundError,
    ConflictError,
    AmountMismatchError,
    BadRequestError,
    GatewayUnavailableError,
    TransportError,
)

try:
    tx = client.get_transaction("tx-id")
except GatewayUnavailableError as e:
    print(f"Retry after {e.retry_after_seconds}s")
except PaymentError as e:
    print(f"Error [{e.code}]: {e}")

from aice_payment import MockPaymentClient, PaymentClientProtocol

def charge(client: PaymentClientProtocol, order_ref: str) -> str:
    resp = client.create_checkout(...)
    return resp.transaction_id

def test_charge() -> None:
    mock = MockPaymentClient()
    txn_id = charge(mock, "ORD-1")
    assert txn_id.startswith("mock-tx-")
    assert mock.last_checkout is not None