convertfilefast-com Billing API

openapi: 3.2.0
info:
  title: ConvertFileFast Billing API
  description: '## ConvertFileFast API


    API for converting files to PDF format.


    ### Supported Formats


    | Format | Extension | Description |

    |--------|-----------|-------------|

    | Excel | .xlsx | Excel spreadsheets |

    | Word | .doc, .docx | Word documents |

    | PowerPoint | .pptx | PowerPoint presentations |

    | ZIP | .zip | Batch conversion of multiple files |

    | Text | .txt | Plain text files |

    | RTF | .rtf | Rich Text Format |

    | ODT | .odt | OpenDocument Text |


    ### Authentication


    All conversion endpoints require an API Key.


    **Option 1: X-API-Key header**

    ```

    X-API-Key: your-api-key

    ```


    **Option 2: Authorization Bearer**

    ```

    Authorization: Bearer your-api-key

    ```


    ### Quick Example


    ```bash

    curl -X POST "https://api.convertfilefast.com/v1/convert" \

    -H "X-API-Key: your-api-key" \

    -F "file=@document.docx" \

    -o document_converted.pdf

    ```'
  contact:
    name: API Support
    email: support@convertfilefast.com
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
  version: 1.0.0
tags:
- name: Billing
paths:
  /v2/billing/status:
    get:
      tags:
      - Billing
      summary: Get Billing Status
      description: Return the user's current plan and credit summary.
      operationId: get_billing_status_v2_billing_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
  /v2/billing/checkout/subscription:
    post:
      tags:
      - Billing
      summary: Create Subscription Checkout
      description: Create a hosted Stripe Checkout link for a subscription plan.
      operationId: create_subscription_checkout_v2_billing_checkout_subscription_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionCheckoutRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
  /v2/billing/checkout/credits:
    post:
      tags:
      - Billing
      summary: Create Credit Checkout
      description: Create a hosted Stripe Checkout link for one-time credit packs.
      operationId: create_credit_checkout_v2_billing_checkout_credits_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreditCheckoutRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
  /v2/billing/portal:
    post:
      tags:
      - Billing
      summary: Create Billing Portal Link
      description: Create a Stripe Billing Portal link for an existing customer.
      operationId: create_billing_portal_link_v2_billing_portal_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
  /v2/billing/auto-recharge:
    get:
      tags:
      - Billing
      summary: Get Auto Recharge Status
      description: 'Return the user''s auto-recharge settings and recent attempt history

        (plan-002 Trilha A, US-011), including the manual payment link for any

        attempt that required authentication or was declined.'
      operationId: get_auto_recharge_status_v2_billing_auto_recharge_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
    post:
      tags:
      - Billing
      summary: Update Auto Recharge Settings
      description: 'Turn automatic recharge on/off and/or change the trigger threshold.

        Returns the same shape as GET /auto-recharge.'
      operationId: update_auto_recharge_settings_v2_billing_auto_recharge_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutoRechargeUpdateRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      - APIKeyHeader: []
components:
  schemas:
    CreditCheckoutRequest:
      properties:
        pack_id:
          type: string
          enum:
          - pack_1000
          - pack_10000
          title: Pack Id
          description: Credit pack to buy.
        currency:
          type: string
          title: Currency
          description: 'Preferred currency: usd, brl, eur, or gbp.'
          default: usd
      type: object
      required:
      - pack_id
      title: CreditCheckoutRequest
    SubscriptionCheckoutRequest:
      properties:
        plan_id:
          type: string
          enum:
          - pro
          - scale
          title: Plan Id
          description: Plan to subscribe to.
        annual:
          type: boolean
          title: Annual
          description: Use annual billing instead of monthly.
          default: false
        currency:
          type: string
          title: Currency
          description: 'Preferred currency: usd, brl, eur, or gbp.'
          default: usd
      type: object
      required:
      - plan_id
      title: SubscriptionCheckoutRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    AutoRechargeUpdateRequest:
      properties:
        enabled:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Enabled
          description: Turn automatic recharge on or off. Omit to leave unchanged.
        threshold_credits:
          anyOf:
          - type: integer
            maximum: 1000000.0
            minimum: 0.0
          - type: 'null'
          title: Threshold Credits
          description: Balance at which auto-recharge fires. Omit to leave unchanged.
      type: object
      title: AutoRechargeUpdateRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key