LovPics Payments API

The payments API from LovPics — 9 operation(s) for payments.

GitHub OpenAPI

Operations 9

POST /api/payments/create-order Create Payment Order #
POST /api/payments/verify Verify Payment #
POST /api/payments/create-order-non-expiring Create Non Expiring Payment Order #
POST /api/payments/verify-non-expiring Verify Non Expiring Payment #
GET /api/payments/first-video-offer/eligibility First Video Offer Eligibility #
POST /api/payments/create-order-first-video Create First Video Offer Order #
POST /api/payments/verify-first-video Verify First Video Offer Payment #
GET /api/payments/test-auth Test Authentication #
GET /api/payments/status/{order_id} Get Payment Status #

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/lovpics-com:lovpics-com-payments-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

lovpics-com-payments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Virtual Studio Payments API
  version: 0.1.0
tags:
- name: Payments
paths:
  /api/payments/create-order:
    post:
      tags:
      - Payments
      summary: Create Payment Order
      description: 'Create a Razorpay order for package purchase.


        Args:

        request: CreateOrderRequest containing package_id

        current_user: Current authenticated user


        Returns:

        CreateOrderResponse with order details


        Raises:

        HTTPException: If package not found or order creation fails'
      operationId: create_payment_order_api_payments_create_order_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrderRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateOrderResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/payments/verify:
    post:
      tags:
      - Payments
      summary: Verify Payment
      description: 'Verify Razorpay payment signature and process successful payment.


        Args:

        request: VerifyPaymentRequest with payment details

        current_user: Current authenticated user


        Returns:

        VerifyPaymentResponse with verification result


        Raises:

        HTTPException: If verification fails or processing error occurs'
      operationId: verify_payment_api_payments_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyPaymentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyPaymentResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/payments/create-order-non-expiring:
    post:
      tags:
      - Payments
      summary: Create Non Expiring Payment Order
      description: 'Create a Razorpay order for non-expiring credits package purchase (pkg_type = 5).


        Args:

        request: CreateNonExpiringOrderRequest containing package_id

        current_user: Current authenticated user


        Returns:

        CreateOrderResponse with order details


        Raises:

        HTTPException: If package not found or order creation fails'
      operationId: create_non_expiring_payment_order_api_payments_create_order_non_expiring_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateNonExpiringOrderRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateOrderResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/payments/verify-non-expiring:
    post:
      tags:
      - Payments
      summary: Verify Non Expiring Payment
      description: 'Verify and process payment for non-expiring credits purchase (pkg_type = 5).

        Credits are added to cr_non_exp_credits column.


        Args:

        request: VerifyNonExpiringPaymentRequest containing payment details

        current_user: Current authenticated user


        Returns:

        VerifyPaymentResponse with verification result


        Raises:

        HTTPException: If verification fails'
      operationId: verify_non_expiring_payment_api_payments_verify_non_expiring_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyNonExpiringPaymentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyPaymentResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/payments/first-video-offer/eligibility:
    get:
      tags:
      - Payments
      summary: First Video Offer Eligibility
      description: Check whether the logged-in user qualifies for the first-video Rs offer.
      operationId: first_video_offer_eligibility_api_payments_first_video_offer_eligibility_get
      security:
      - HTTPBearer: []
      parameters:
      - name: credits_required
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Credits needed for the pending video
          default: 0
          title: Credits Required
        description: Credits needed for the pending video
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FirstVideoOfferEligibilityResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/payments/create-order-first-video:
    post:
      tags:
      - Payments
      summary: Create First Video Offer Order
      description: Create a Razorpay order for the first-video promotional offer.
      operationId: create_first_video_offer_order_api_payments_create_order_first_video_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateOrderResponse'
      security:
      - HTTPBearer: []
  /api/payments/verify-first-video:
    post:
      tags:
      - Payments
      summary: Verify First Video Offer Payment
      description: Verify Razorpay payment and grant first-video offer credits.
      operationId: verify_first_video_offer_payment_api_payments_verify_first_video_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyFirstVideoOfferRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyPaymentResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/payments/test-auth:
    get:
      tags:
      - Payments
      summary: Test Authentication
      description: 'Test endpoint to verify authentication is working.


        Args:

        current_user: Current authenticated user


        Returns:

        dict: User information if authentication successful'
      operationId: test_authentication_api_payments_test_auth_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/payments/status/{order_id}:
    get:
      tags:
      - Payments
      summary: Get Payment Status
      description: 'Get payment status for a Razorpay order.


        Args:

        order_id: Razorpay order ID

        current_user: Current authenticated user


        Returns:

        PaymentStatusResponse with payment status


        Raises:

        HTTPException: If order not found or status check fails'
      operationId: get_payment_status_api_payments_status__order_id__get
      security:
      - HTTPBearer: []
      parameters:
      - name: order_id
        in: path
        required: true
        schema:
          type: string
          title: Order Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CreateOrderRequest:
      properties:
        package_id:
          type: integer
          title: Package Id
          description: Package ID to purchase
        custom_amount:
          anyOf:
          - type: number
          - type: 'null'
          title: Custom Amount
          description: Custom amount for top-ups (overrides package amount)
        top_up_credits:
          anyOf:
          - type: integer
          - type: 'null'
          title: Top Up Credits
          description: Custom credits for top-ups (overrides package credits)
      type: object
      required:
      - package_id
      title: CreateOrderRequest
    VerifyFirstVideoOfferRequest:
      properties:
        razorpay_order_id:
          type: string
          title: Razorpay Order Id
          description: Razorpay order ID
        razorpay_payment_id:
          type: string
          title: Razorpay Payment Id
          description: Razorpay payment ID
        razorpay_signature:
          type: string
          title: Razorpay Signature
          description: Razorpay payment signature
        fbp:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbp
          description: Meta _fbp cookie for CAPI matching
        fbc:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbc
          description: Meta _fbc cookie for CAPI matching
      type: object
      required:
      - razorpay_order_id
      - razorpay_payment_id
      - razorpay_signature
      title: VerifyFirstVideoOfferRequest
    VerifyNonExpiringPaymentRequest:
      properties:
        razorpay_order_id:
          type: string
          title: Razorpay Order Id
          description: Razorpay order ID
        razorpay_payment_id:
          type: string
          title: Razorpay Payment Id
          description: Razorpay payment ID
        razorpay_signature:
          type: string
          title: Razorpay Signature
          description: Razorpay payment signature
        package_id:
          type: integer
          title: Package Id
          description: Package ID that was purchased
        fbp:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbp
          description: Meta _fbp cookie for CAPI matching
        fbc:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbc
          description: Meta _fbc cookie for CAPI matching
      type: object
      required:
      - razorpay_order_id
      - razorpay_payment_id
      - razorpay_signature
      - package_id
      title: VerifyNonExpiringPaymentRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CreateNonExpiringOrderRequest:
      properties:
        package_id:
          type: integer
          title: Package Id
          description: Package ID to purchase (must be pkg_type = 5)
        mc_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Mc Id
          description: Optional marketer coupon id from GET /api/marketer/coupon/lookup
      type: object
      required:
      - package_id
      title: CreateNonExpiringOrderRequest
    FirstVideoOfferEligibilityResponse:
      properties:
        eligible:
          type: boolean
          title: Eligible
        priceInr:
          type: number
          title: Priceinr
        creditsGranted:
          type: integer
          title: Creditsgranted
        hasGeneratedVideo:
          type: boolean
          title: Hasgeneratedvideo
        hasPurchasedOffer:
          type: boolean
          title: Haspurchasedoffer
        availableCredits:
          type: integer
          title: Availablecredits
        creditsRequired:
          type: integer
          title: Creditsrequired
        insufficientCredits:
          type: boolean
          title: Insufficientcredits
      type: object
      required:
      - eligible
      - priceInr
      - creditsGranted
      - hasGeneratedVideo
      - hasPurchasedOffer
      - availableCredits
      - creditsRequired
      - insufficientCredits
      title: FirstVideoOfferEligibilityResponse
    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
    VerifyPaymentResponse:
      properties:
        success:
          type: boolean
          title: Success
        message:
          type: string
          title: Message
        transaction_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Transaction Id
        credits_added:
          anyOf:
          - type: integer
          - type: 'null'
          title: Credits Added
        amount:
          anyOf:
          - type: number
          - type: 'null'
          title: Amount
          description: Charged amount in major currency units (INR)
        currency:
          anyOf:
          - type: string
          - type: 'null'
          title: Currency
          description: ISO currency code, e.g. INR
        event_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Event Id
          description: Meta deduplication id (Razorpay payment id)
      type: object
      required:
      - success
      - message
      title: VerifyPaymentResponse
    VerifyPaymentRequest:
      properties:
        razorpay_order_id:
          type: string
          title: Razorpay Order Id
        razorpay_payment_id:
          type: string
          title: Razorpay Payment Id
        razorpay_signature:
          type: string
          title: Razorpay Signature
        package_id:
          type: integer
          title: Package Id
        top_up_credits:
          anyOf:
          - type: integer
          - type: 'null'
          title: Top Up Credits
          description: Custom credits for top-ups (overrides package credits)
        fbp:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbp
          description: Meta _fbp cookie for CAPI matching
        fbc:
          anyOf:
          - type: string
          - type: 'null'
          title: Fbc
          description: Meta _fbc cookie for CAPI matching
      type: object
      required:
      - razorpay_order_id
      - razorpay_payment_id
      - razorpay_signature
      - package_id
      title: VerifyPaymentRequest
    CreateOrderResponse:
      properties:
        order_id:
          type: string
          title: Order Id
        amount:
          type: integer
          title: Amount
        currency:
          type: string
          title: Currency
        key_id:
          type: string
          title: Key Id
        package_info:
          additionalProperties: true
          type: object
          title: Package Info
        prefill_contact:
          anyOf:
          - type: string
          - type: 'null'
          title: Prefill Contact
          description: Digits-only phone for Razorpay checkout.prefill.contact
        prefill_email:
          anyOf:
          - type: string
          - type: 'null'
          title: Prefill Email
          description: Email hint for Razorpay checkout.prefill.email
      type: object
      required:
      - order_id
      - amount
      - currency
      - key_id
      - package_info
      title: CreateOrderResponse
    PaymentStatusResponse:
      properties:
        status:
          type: string
          title: Status
        payment_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Payment Id
        amount:
          anyOf:
          - type: integer
          - type: 'null'
          title: Amount
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
      type: object
      required:
      - status
      title: PaymentStatusResponse
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer