svc-infra 0.1.562__py3-none-any.whl → 0.1.654__py3-none-any.whl

svc_infra/apf_payments/schemas.py

@@ -24,7 +24,7 @@ class CustomerOut(BaseModel):
 
 class IntentCreateIn(BaseModel):
     amount: AmountMinor = Field(..., description="Minor units (e.g., cents)")
-    currency: Currency = Field(..., example="USD")
+    currency: Currency = Field(..., json_schema_extra={"example": "USD"})
     description: Optional[str] = None
     capture_method: Literal["automatic", "manual"] = "automatic"
     payment_method_types: list[str] = Field(default_factory=list)  # let provider default
@@ -169,3 +169,165 @@ class InvoiceOut(BaseModel):
     currency: Currency
     hosted_invoice_url: Optional[str] = None
     pdf_url: Optional[str] = None
+
+
+class CaptureIn(BaseModel):
+    amount: Optional[AmountMinor] = None  # partial capture supported
+
+
+class IntentListFilter(BaseModel):
+    customer_provider_id: Optional[str] = None
+    status: Optional[str] = None
+    limit: Optional[int] = Field(default=50, ge=1, le=200)
+    cursor: Optional[str] = None  # opaque provider cursor when supported
+
+
+class UsageRecordIn(BaseModel):
+    # Stripe: subscription_item is the target for metered billing.
+    # If provider doesn't use subscription_item, allow provider_price_id as fallback.
+    subscription_item: Optional[str] = None
+    provider_price_id: Optional[str] = None
+    quantity: conint(ge=0)
+    timestamp: Optional[int] = None  # Unix seconds; provider defaults to "now"
+    action: Optional[Literal["increment", "set"]] = "increment"
+
+
+class InvoiceLineItemIn(BaseModel):
+    customer_provider_id: str
+    description: Optional[str] = None
+    unit_amount: AmountMinor
+    currency: Currency
+    quantity: Optional[int] = 1
+    provider_price_id: Optional[str] = None  # if linked to a price, unit_amount may be ignored
+
+
+class InvoicesListFilter(BaseModel):
+    customer_provider_id: Optional[str] = None
+    status: Optional[str] = None
+    limit: Optional[int] = Field(default=50, ge=1, le=200)
+    cursor: Optional[str] = None
+
+
+class SetupIntentOut(BaseModel):
+    id: str
+    provider: str
+    provider_setup_intent_id: str
+    status: str
+    client_secret: Optional[str] = None
+    next_action: Optional[NextAction] = None
+
+
+class DisputeOut(BaseModel):
+    id: str
+    provider: str
+    provider_dispute_id: str
+    amount: AmountMinor
+    currency: Currency
+    reason: Optional[str] = None
+    status: str
+    evidence_due_by: Optional[str] = None
+    created_at: Optional[str] = None
+
+
+class PayoutOut(BaseModel):
+    id: str
+    provider: str
+    provider_payout_id: str
+    amount: AmountMinor
+    currency: Currency
+    status: str
+    arrival_date: Optional[str] = None
+    type: Optional[str] = None
+
+
+class BalanceAmount(BaseModel):
+    currency: Currency
+    amount: AmountMinor
+
+
+class BalanceSnapshotOut(BaseModel):
+    available: list[BalanceAmount] = Field(default_factory=list)
+    pending: list[BalanceAmount] = Field(default_factory=list)
+
+
+class SetupIntentCreateIn(BaseModel):
+    payment_method_types: list[str] = Field(default_factory=lambda: ["card"])
+
+
+class WebhookReplayIn(BaseModel):
+    event_ids: Optional[list[str]] = None
+
+
+class WebhookReplayOut(BaseModel):
+    replayed: int
+
+
+class WebhookAckOut(BaseModel):
+    ok: bool
+
+
+class UsageRecordOut(BaseModel):
+    id: str
+    quantity: int
+    timestamp: Optional[int] = None
+    subscription_item: Optional[str] = None
+    provider_price_id: Optional[str] = None
+    action: Optional[Literal["increment", "set"]] = None
+
+
+# -------- Customers list filter ----------
+class CustomersListFilter(BaseModel):
+    provider: Optional[str] = None
+    user_id: Optional[str] = None
+    limit: Optional[int] = Field(default=50, ge=1, le=200)
+    cursor: Optional[str] = None  # we’ll paginate on provider_customer_id asc
+
+
+# -------- Products / Prices updates ----------
+class ProductUpdateIn(BaseModel):
+    name: Optional[str] = None
+    active: Optional[bool] = None
+
+
+class PriceUpdateIn(BaseModel):
+    active: Optional[bool] = None
+
+
+# -------- Payment Method update ----------
+class PaymentMethodUpdateIn(BaseModel):
+    # keep minimal + commonly supported card fields
+    name: Optional[str] = None
+    exp_month: Optional[int] = None
+    exp_year: Optional[int] = None
+    # extend here later with address fields (line1, city, etc.)
+
+
+# -------- Refunds (list/get) ----------
+class RefundOut(BaseModel):
+    id: str
+    provider: str
+    provider_refund_id: str
+    provider_payment_intent_id: Optional[str] = None
+    amount: AmountMinor
+    currency: Currency
+    status: str
+    reason: Optional[str] = None
+    created_at: Optional[str] = None
+
+
+# -------- Invoice line items (list) ----------
+class InvoiceLineItemOut(BaseModel):
+    id: str
+    description: Optional[str] = None
+    amount: AmountMinor
+    currency: Currency
+    quantity: Optional[int] = 1
+    provider_price_id: Optional[str] = None
+
+
+# -------- Usage records list/get ----------
+class UsageRecordListFilter(BaseModel):
+    subscription_item: Optional[str] = None
+    provider_price_id: Optional[str] = None
+    limit: Optional[int] = Field(default=50, ge=1, le=200)
+    cursor: Optional[str] = None