LovPics Payments API
The payments API from LovPics — 9 operation(s) for payments.
The payments API from LovPics — 9 operation(s) for payments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/lovpics-com:lovpics-com-payments-api"
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.
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: 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