MinglesAI Billing API

The Billing API from MinglesAI — 21 operation(s) for billing.

GitHub OpenAPI

Operations 21

POST /billing/promo/preview Preview Promo Code #
POST /billing/promo/redeem Redeem Promo Code #
GET /billing/me Billing Me #
GET /billing/models/rates Model Rates #
GET /billing/usage Billing Usage #
POST /billing/promo/claim Promo Claim #
GET /billing/pricing List Plans #
POST /billing/checkout/topup Checkout Topup #
POST /billing/checkout/subscribe Checkout Subscribe #
POST /billing/checkout/crypto-topup Checkout Crypto Topup #
POST /billing/checkout/subscribe-from-balance Checkout Subscribe From Balance #
POST /billing/checkout/subscribe-crypto Checkout Subscribe Crypto #
GET /billing/crypto/currencies Crypto Currencies #
GET /billing/platega/quote Platega Quote #
POST /billing/checkout/platega-topup Checkout Platega Topup #
POST /billing/checkout/platega-subscribe Checkout Platega Subscribe #
POST /billing/subscription/cancel-renewal Cancel Subscription Renewal #
POST /billing/subscription/resume Resume Subscription #
POST /billing/stripe/webhook Stripe Webhook #
POST /billing/nowpayments/webhook Nowpayments Webhook #
POST /billing/platega/webhook Platega Webhook #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mingles-ai:mingles-ai-billing-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mingles-ai-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gonka Proxy Billing API
  description: OpenAI-compatible AI proxy with token-based billing
  version: 2.0.0
tags:
- name: Billing
paths:
  /billing/promo/preview:
    post:
      summary: Preview Promo Code
      description: 'Validate a promo code WITHOUT redeeming it (so the checkout UI can show the

        discount and the user can re-check the same code freely).'
      operationId: preview_promo_code_billing_promo_preview_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
      tags:
      - Billing
  /billing/promo/redeem:
    post:
      summary: Redeem Promo Code
      description: Redeem a promo code for the authenticated user (balance / discount / free_sub).
      operationId: redeem_promo_code_billing_promo_redeem_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
      tags:
      - Billing
  /billing/me:
    get:
      tags:
      - Billing
      summary: Billing Me
      description: Current user's balances, subscriptions, referral, brand.
      operationId: billing_me_billing_me_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Billing Me Billing Me Get
      security:
      - HTTPBearer: []
  /billing/models/rates:
    get:
      tags:
      - Billing
      summary: Model Rates
      description: Public per-model rate card — what the console and docs render.
      operationId: model_rates_billing_models_rates_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Model Rates Billing Models Rates Get
  /billing/usage:
    get:
      tags:
      - Billing
      summary: Billing Usage
      description: 'Plan consumption as percentages — the only usage shape we expose publicly.


        Three bars (5-hour window, week, billing period) plus a per-model burn rate, and

        deliberately no absolute numbers. Token counts and dollar amounts stay server-side

        so the limits can be retuned without contradicting something a user was shown; a

        percentage of "your plan" survives a retune, "6M tokens" does not.


        The burn rate is each model''s price relative to the cheapest one we serve, which

        is what the model picker shows next to the name ("×2 — spends your plan twice as

        fast"). It falls out of the price table, so a repricing updates it for free.'
      operationId: billing_usage_billing_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Billing Usage Billing Usage Get
      security:
      - HTTPBearer: []
  /billing/promo/claim:
    post:
      tags:
      - Billing
      summary: Promo Claim
      description: 'Apply signup channel + referral bonuses. Idempotent: 200 with reason on retry.'
      operationId: promo_claim_billing_promo_claim_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromoClaimRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Promo Claim Billing Promo Claim Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/pricing:
    get:
      tags:
      - Billing
      summary: List Plans
      description: 'Public plan list (single USD product — all active plans).


        Agency tiers (plan_group == "agency") are excluded by default so they stay

        out of the self-serve /app picker; pass ?group=agency to fetch only those.

        They remain chargeable by code via /billing/checkout/subscribe regardless.


        Internal plans (plan_group == "internal" — the service tier handed to test

        accounts) are never listed, whatever group the caller asks for, and every

        checkout endpoint refuses them.'
      operationId: list_plans_billing_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Plans Billing Pricing Get
  /billing/checkout/topup:
    post:
      tags:
      - Billing
      summary: Checkout Topup
      operationId: checkout_topup_billing_checkout_topup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Topup Billing Checkout Topup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout/subscribe:
    post:
      tags:
      - Billing
      summary: Checkout Subscribe
      operationId: checkout_subscribe_billing_checkout_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Subscribe Billing Checkout Subscribe Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout/crypto-topup:
    post:
      tags:
      - Billing
      summary: Checkout Crypto Topup
      description: 'One-time crypto top-up via NOWPayments (stable-coins). Credits the

        prepaid USD inference balance at the confirmed amount.'
      operationId: checkout_crypto_topup_billing_checkout_crypto_topup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CryptoTopupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Crypto Topup Billing Checkout Crypto Topup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout/subscribe-from-balance:
    post:
      tags:
      - Billing
      summary: Checkout Subscribe From Balance
      description: 'Activate a paid plan by debiting the user''s prepaid USD balance.


        On insufficient funds, responds 402 with a body the UI can use to deep-link

        into the top-up flow (top-up minimum = the shortfall, rounded up to the

        nearest $1).'
      operationId: checkout_subscribe_from_balance_billing_checkout_subscribe_from_balance_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Subscribe From Balance Billing Checkout Subscribe From Balance Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout/subscribe-crypto:
    post:
      tags:
      - Billing
      summary: Checkout Subscribe Crypto
      description: 'Pay a subscription with crypto (NOWPayments invoice). Activates a 30-day

        plan period on confirmed IPN. No auto-renewal — user pays again to extend.'
      operationId: checkout_subscribe_crypto_billing_checkout_subscribe_crypto_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CryptoSubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Subscribe Crypto Billing Checkout Subscribe Crypto Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/crypto/currencies:
    get:
      tags:
      - Billing
      summary: Crypto Currencies
      description: Pay currencies allowed for crypto top-up (stable-coins).
      operationId: crypto_currencies_billing_crypto_currencies_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Crypto Currencies Billing Crypto Currencies Get
  /billing/platega/quote:
    get:
      tags:
      - Billing
      summary: Platega Quote
      description: 'USD→RUB estimate (CBR rate + markup) so the wizard can show `≈ ₽…`.

        The authoritative ruble amount is fixed at checkout-creation time.'
      operationId: platega_quote_billing_platega_quote_get
      parameters:
      - name: usd
        in: query
        required: true
        schema:
          type: number
          title: Usd
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Platega Quote Billing Platega Quote Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /billing/checkout/platega-topup:
    post:
      tags:
      - Billing
      summary: Checkout Platega Topup
      description: 'One-time RUB top-up via Platega (СБП / crypto). Credits the prepaid USD

        balance with the full requested amount on confirmation.'
      operationId: checkout_platega_topup_billing_checkout_platega_topup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlategaTopupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Platega Topup Billing Checkout Platega Topup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout/platega-subscribe:
    post:
      tags:
      - Billing
      summary: Checkout Platega Subscribe
      description: 'Pay a subscription in RUB via Platega. Activates a 30-day period on

        confirmation. No auto-renewal — the user pays again to extend.'
      operationId: checkout_platega_subscribe_billing_checkout_platega_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlategaSubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Checkout Platega Subscribe Billing Checkout Platega Subscribe Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/subscription/cancel-renewal:
    post:
      tags:
      - Billing
      summary: Cancel Subscription Renewal
      description: 'Turn off auto-renewal on the active paid subscription. The user keeps

        plan benefits until period_end, then drops to Free automatically.'
      operationId: cancel_subscription_renewal_billing_subscription_cancel_renewal_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Cancel Subscription Renewal Billing Subscription Cancel Renewal Post
      security:
      - HTTPBearer: []
  /billing/subscription/resume:
    post:
      tags:
      - Billing
      summary: Resume Subscription
      description: Reverse a pending cancel-at-period-end so the paid plan renews again.
      operationId: resume_subscription_billing_subscription_resume_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Resume Subscription Billing Subscription Resume Post
      security:
      - HTTPBearer: []
  /billing/stripe/webhook:
    post:
      tags:
      - Billing
      summary: Stripe Webhook
      description: Stripe-signed webhook; verifies HMAC then dispatches via process_event.
      operationId: stripe_webhook_billing_stripe_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /billing/nowpayments/webhook:
    post:
      tags:
      - Billing
      summary: Nowpayments Webhook
      description: 'NOWPayments IPN. Header: x-nowpayments-sig (HMAC-SHA512 over sorted JSON).'
      operationId: nowpayments_webhook_billing_nowpayments_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /billing/platega/webhook:
    post:
      tags:
      - Billing
      summary: Platega Webhook
      description: 'Platega status-change callback. Authenticated by the X-MerchantId /

        X-Secret headers (no HMAC in Platega''s spec); we constant-time compare them

        and re-confirm the status via the API before crediting. Reply 200 within 60s

        or Platega retries up to 3× at 5-min intervals.'
      operationId: platega_webhook_billing_platega_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
components:
  schemas:
    SubscribeRequest:
      properties:
        plan_code:
          type: string
          title: Plan Code
          description: mini|standard|team
      type: object
      required:
      - plan_code
      title: SubscribeRequest
    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
    PromoClaimRequest:
      properties:
        signup_channel:
          anyOf:
          - type: string
          - type: 'null'
          title: Signup Channel
          description: utm_source / channel code
        referred_by:
          anyOf:
          - type: string
          - type: 'null'
          title: Referred By
          description: Inviter referral_code
      type: object
      title: PromoClaimRequest
    PlategaSubscribeRequest:
      properties:
        plan_code:
          type: string
          title: Plan Code
          description: mini|standard|team
        method:
          type: integer
          title: Method
          description: 'Platega paymentMethod: 2=СБП/QR, 13=crypto'
      type: object
      required:
      - plan_code
      - method
      title: PlategaSubscribeRequest
    TopupRequest:
      properties:
        amount_usd:
          type: number
          exclusiveMinimum: 0.0
          title: Amount Usd
          description: Top-up amount in USD
      type: object
      required:
      - amount_usd
      title: TopupRequest
    PlategaTopupRequest:
      properties:
        amount_usd:
          type: number
          exclusiveMinimum: 0.0
          title: Amount Usd
          description: Credit amount in USD
        method:
          type: integer
          title: Method
          description: 'Platega paymentMethod: 2=СБП/QR, 13=crypto'
        promo_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Promo Code
          description: optional promo discount code
      type: object
      required:
      - amount_usd
      - method
      title: PlategaTopupRequest
    CryptoTopupRequest:
      properties:
        amount_usd:
          type: number
          exclusiveMinimum: 0.0
          title: Amount Usd
          description: Credit amount in USD-equivalent
        pay_currency:
          type: string
          title: Pay Currency
          description: usdtbsc|usdttrc20|usdcbsc
        promo_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Promo Code
          description: optional promo discount code
      type: object
      required:
      - amount_usd
      - pay_currency
      title: CryptoTopupRequest
    CryptoSubscribeRequest:
      properties:
        plan_code:
          type: string
          title: Plan Code
          description: mini|standard|team
        pay_currency:
          type: string
          title: Pay Currency
          description: usdtbsc|usdttrc20|usdcbsc
      type: object
      required:
      - plan_code
      - pay_currency
      title: CryptoSubscribeRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer