Indox Auth API - OSLLM AI

Payments & Purchase Initiation

List purchase history. 12.1

GET

/auth/api/v1/billing/purchase_history/

Use Cases

This endpoint is typically used for:

Code
 
✅ Users viewing their own purchase history

✅ Admins monitoring all purchase transactions

✅ Building purchase history dashboards

✅ Tracking payment statuses and amounts

✅ Auditing billing transactions

List purchase history. 12.1 › query Parameters

page

integer

Default: 1

page_size

integer

Default: 20

List purchase history. 12.1 › Responses

200

object[] · required

object · required

GET/auth/api/v1/billing/purchase_history/

import requests

url = "/auth/api/v1/billing/purchase_history/"

response = requests.get(url)

print(response.text)

python

Example Responses

{
  "transactions": [
    {
      "transaction_id": "transaction_id",
      "session_id": "string",
      "amount": 0,
      "created_at": "created_at",
      "payment_method": "payment_method",
      "status": "status",
      "description": "description",
      "pricing_breakdown": {
        "total_amount_cents": 0,
        "currency": "currency",
        "formatted": {}
      },
      "formatted_date": "formatted_date"
    }
  ],
  "pagination": {
    "total_count": 0,
    "limit": 0,
    "offset": 0,
    "has_more": true
  }
}

json

application/json

Initiate a subscription purchase. 9.8

POST

/auth/api/v1/billing/purchase_initiate/

Initiate a subscription purchase. 9.8 › Request Body

price_plan_id

string · required

Initiate a subscription purchase. 9.8 › Responses

200

POST/auth/api/v1/billing/purchase_initiate/

import requests

url = "/auth/api/v1/billing/purchase_initiate/"

payload = {
    "price_plan_id": "price_plan_id",
    "next_url": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

python

Example Request Body

{
  "price_plan_id": "price_plan_id",
  "next_url": "string"
}

json

Example Responses

{}

json

application/json

Initiate a pay-as-you-go purchase. 9.9

POST

/auth/api/v1/billing/purchase_initiate/pay-as-you-go/

Initiate a pay-as-you-go purchase. 9.9 › Request Body

amount

integer · required

Initiate a pay-as-you-go purchase. 9.9 › Responses

200

POST/auth/api/v1/billing/purchase_initiate/pay-as-you-go/

import requests

url = "/auth/api/v1/billing/purchase_initiate/pay-as-you-go/"

payload = {
    "amount": 0,
    "next_url": "string"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

python

Example Request Body

{
  "amount": 0,
  "next_url": "string"
}

json

Example Responses

{}

json

application/json

Stripe checkout return callback. Backend verifies payment then redirects to frontend.

GET

/auth/api/v1/billing/purchase_initiate/callback/

Stripe Checkout redirect target.

Stripe sends the user here after payment (success or cancel). We:

Fetch the Checkout Session from Stripe using the secret key
Reuse the common completion logic (same as webhook) to finalize purchase
Redirect browser to the original next_url (if provided) or fallback frontend page

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › query Parameters

session_id

string · required

result

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › Responses

200

No data returned

GET/auth/api/v1/billing/purchase_initiate/callback/

import requests

url = "/auth/api/v1/billing/purchase_initiate/callback/?session_id=%3Cstring%3E"

response = requests.get(url)

print(response.text)

python

Example Responses

No example specified for this content type

POST

/auth/api/v1/billing/credits/promo-code/

Apply a promo code to user's account.

code

string · required

200

success

boolean · required

message

string · required

POST/auth/api/v1/billing/credits/promo-code/

import requests

url = "/auth/api/v1/billing/credits/promo-code/"

payload = {
    "code": "code",
    "purchase_amount": 0
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

python

Example Request Body

{
  "code": "code",
  "purchase_amount": 0
}

json

Example Responses

{
  "success": true,
  "message": "message",
  "credits_granted": 0
}

json

application/json

Pricing Plans Task Completion

List purchase history. 12.1

GET

/auth/api/v1/billing/purchase_history/

Use Cases

This endpoint is typically used for:

Code
 
✅ Users viewing their own purchase history

✅ Admins monitoring all purchase transactions

✅ Building purchase history dashboards

✅ Tracking payment statuses and amounts

✅ Auditing billing transactions

List purchase history. 12.1 › query Parameters

page

integer

Default: 1

page_size

integer

Default: 20

List purchase history. 12.1 › Responses

200

object[] · required

object · required

Stripe checkout return callback. Backend verifies payment then redirects to frontend.

GET

/auth/api/v1/billing/purchase_initiate/callback/

Stripe Checkout redirect target.

Stripe sends the user here after payment (success or cancel). We:

Fetch the Checkout Session from Stripe using the secret key
Reuse the common completion logic (same as webhook) to finalize purchase
Redirect browser to the original next_url (if provided) or fallback frontend page

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › query Parameters

session_id

string · required

result

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › Responses

200

No data returned

Apply a promo code to get credits. 9.14

POST

/auth/api/v1/billing/credits/promo-code/

Apply a promo code to user's account.

code

string · required

200

success

boolean · required

message

string · required

Payments & Purchase Initiation

List purchase history. 12.1

List purchase history. 12.1 › query Parameters

List purchase history. 12.1 › Responses

Initiate a subscription purchase. 9.8

Initiate a subscription purchase. 9.8 › Request Body

Initiate a subscription purchase. 9.8 › Responses

Initiate a pay-as-you-go purchase. 9.9

Initiate a pay-as-you-go purchase. 9.9 › Request Body

Initiate a pay-as-you-go purchase. 9.9 › Responses

Stripe checkout return callback. Backend verifies payment then redirects to frontend.

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › query Parameters

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › Responses

Apply a promo code to get credits. 9.14

Apply a promo code to get credits. 9.14 › Request Body

Apply a promo code to get credits. 9.14 › Responses

Payments & Purchase Initiation

List purchase history. 12.1

List purchase history. 12.1 › query Parameters

List purchase history. 12.1 › Responses

Initiate a subscription purchase. 9.8

Initiate a subscription purchase. 9.8 › Request Body

Initiate a subscription purchase. 9.8 › Responses

Initiate a pay-as-you-go purchase. 9.9

Initiate a pay-as-you-go purchase. 9.9 › Request Body

Initiate a pay-as-you-go purchase. 9.9 › Responses

Stripe checkout return callback. Backend verifies payment then redirects to frontend.

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › query Parameters

Stripe checkout return callback. Backend verifies payment then redirects to frontend. › Responses

Apply a promo code to get credits. 9.14

Apply a promo code to get credits. 9.14 › Request Body

Apply a promo code to get credits. 9.14 › Responses