dialogbrain-com Partner Config API

openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway Partner Config API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: partner-config
paths:
  /api/partner/config:
    get:
      tags:
      - partner-config
      summary: Get Partner Config
      operationId: get_partner_config_api_partner_config_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerConfigResponse'
    put:
      tags:
      - partner-config
      summary: Update Partner Config
      operationId: update_partner_config_api_partner_config_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerConfigUpdate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerConfigResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/partner/sales:
    get:
      tags:
      - partner-config
      summary: Get Partner Sales
      description: 'The partner''s own book: who paid, how much, and who is still paying.


        Money comes from the invoice ledger, so a Stripe webhook re-delivery can

        never inflate it, and a renewal counts the same way the first month does.'
      operationId: get_partner_sales_api_partner_sales_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerSalesResponse'
  /api/partner/checkout:
    post:
      tags:
      - partner-config
      summary: Create Partner Checkout
      description: 'Mint a Stripe payment page at the price the partner named.


        Authenticated with the partner''s own API key, so the partner identity —

        and with it the price floor, the metadata and the workspace the sale lands

        in — is decided here rather than sent by the caller. That is the reason

        this endpoint exists instead of a Stripe key in the partner''s hands.'
      operationId: create_partner_checkout_api_partner_checkout_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/src__api__partner_config__CheckoutRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/src__api__partner_config__CheckoutResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    src__api__partner_config__CheckoutResponse:
      properties:
        checkout_url:
          type: string
          title: Checkout Url
        session_id:
          type: string
          title: Session Id
        order_ref:
          type: string
          title: Order Ref
        reused:
          type: boolean
          title: Reused
      type: object
      required:
      - checkout_url
      - session_id
      - order_ref
      - reused
      title: CheckoutResponse
    PartnerSaleRow:
      properties:
        id:
          type: integer
          title: Id
        venue_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Venue Name
        customer_email:
          anyOf:
          - type: string
          - type: 'null'
          title: Customer Email
        status:
          type: string
          title: Status
        subscription_status:
          anyOf:
          - type: string
          - type: 'null'
          title: Subscription Status
        current_period_end:
          anyOf:
          - type: string
          - type: 'null'
          title: Current Period End
        revoked:
          type: boolean
          title: Revoked
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        paid_cents:
          type: integer
          title: Paid Cents
        payments:
          type: integer
          title: Payments
        currency:
          type: string
          title: Currency
      type: object
      required:
      - id
      - status
      - revoked
      - paid_cents
      - payments
      - currency
      title: PartnerSaleRow
    src__api__partner_config__CheckoutRequest:
      properties:
        order_ref:
          type: string
          title: Order Ref
        venue_name:
          type: string
          title: Venue Name
        amount_cents:
          anyOf:
          - type: integer
          - type: 'null'
          title: Amount Cents
        monthly_cents:
          anyOf:
          - type: integer
          - type: 'null'
          title: Monthly Cents
        currency:
          type: string
          title: Currency
          default: eur
        email:
          anyOf:
          - type: string
          - type: 'null'
          title: Email
      type: object
      required:
      - order_ref
      - venue_name
      title: CheckoutRequest
      description: 'One purchase, priced by the partner''s own site.


        `amount_cents` is the one-off part (setup, a bundle, a promotion) and

        `monthly_cents` the recurring part. Either may be zero; together they must

        reach the first charge. `order_ref` is the partner''s own order number and

        is what makes a retry safe.'
    PartnerConfigResponse:
      properties:
        partner_key:
          type: string
          title: Partner Key
        display_name:
          type: string
          title: Display Name
        return_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Return Url
        payment_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Payment Url
        locale:
          type: string
          title: Locale
        primary_color:
          type: string
          title: Primary Color
      type: object
      required:
      - partner_key
      - display_name
      - locale
      - primary_color
      title: PartnerConfigResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PartnerCurrencyTotals:
      properties:
        currency:
          type: string
          title: Currency
        gross_cents:
          type: integer
          title: Gross Cents
        month_cents:
          type: integer
          title: Month Cents
        refunded_cents:
          type: integer
          title: Refunded Cents
          default: 0
        payments:
          type: integer
          title: Payments
      type: object
      required:
      - currency
      - gross_cents
      - month_cents
      - payments
      title: PartnerCurrencyTotals
    PartnerSalesResponse:
      properties:
        currency:
          type: string
          title: Currency
        gross_cents:
          type: integer
          title: Gross Cents
        month_cents:
          type: integer
          title: Month Cents
        payments:
          type: integer
          title: Payments
        refunded_cents:
          type: integer
          title: Refunded Cents
          default: 0
        customers:
          type: integer
          title: Customers
        active_customers:
          type: integer
          title: Active Customers
        churned_customers:
          type: integer
          title: Churned Customers
        failed_signups:
          type: integer
          title: Failed Signups
        other_currencies:
          items:
            $ref: '#/components/schemas/PartnerCurrencyTotals'
          type: array
          title: Other Currencies
          default: []
        sales:
          items:
            $ref: '#/components/schemas/PartnerSaleRow'
          type: array
          title: Sales
      type: object
      required:
      - currency
      - gross_cents
      - month_cents
      - payments
      - customers
      - active_customers
      - churned_customers
      - failed_signups
      - sales
      title: PartnerSalesResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    PartnerConfigUpdate:
      properties:
        return_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Return Url
      type: object
      required:
      - return_url
      title: PartnerConfigUpdate