> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pay Invoice With Balance

> Pay the outstanding invoice balance using account credit. Supports partial payment if balance is insufficient.



## OpenAPI

````yaml POST /customer/v2/invoices/{invoice}/pay-with-balance
openapi: 3.0.3
info:
  title: OrbitFlare Customer API
  description: >-
    API documentation for the OrbitFlare Customer API. This API allows
    authenticated customers to manage their licenses, whitelist IPs, reset keys,
    and retrieve associated data. Supports v1 (API key only) and v2 (Bearer
    token or API key) with extended features including device/wallet auth, API
    keys management, profile, Solana USDC balance top-up, and RPC plan
    purchasing.
  version: 2.1.0
servers:
  - url: https://orbitflare.com/api
    description: OrbitFlare Production server
security:
  - api_key: []
tags:
  - name: Auth
    description: Authentication (device flow, wallet signature, session)
  - name: Licenses
    description: License management
  - name: API Keys
    description: API key management
  - name: Profile
    description: User profile and balance
  - name: Invoices
    description: Invoice listing, detail, and balance payment
  - name: Top-Up
    description: Balance top-up via Solana USDC
  - name: RPC Plans
    description: Solana RPC plan catalog
  - name: Orders
    description: Order management (validate, purchase, list)
paths:
  /customer/v2/invoices/{invoice}/pay-with-balance:
    parameters:
      - name: invoice
        in: path
        description: Invoice reference.
        required: true
        schema:
          type: string
    post:
      tags:
        - Invoices
      summary: Pay Invoice With Balance
      description: >-
        Pay the outstanding invoice balance using account credit. Supports
        partial payment if balance is insufficient.
      operationId: payInvoiceWithBalance
      responses:
        '200':
          description: Payment processed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      balance_used:
                        type: number
                        format: float
                      remainder:
                        type: number
                        format: float
                      invoice_status:
                        type: string
                      new_user_balance:
                        type: number
                        format: float
        '400':
          description: No balance due or invoice cancelled.
        '403':
          description: Unauthorized access.
        '404':
          description: Invoice not found.
      security:
        - bearer_token: []
        - api_key: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      name: X-ORBIT-KEY
      in: header
      description: API key for v1 and v2 (when not using Bearer token)
    bearer_token:
      type: http
      scheme: bearer
      bearerFormat: Sanctum
      description: Bearer token from device or wallet auth

````