Entity Credit Tier | Quest Protocol

Quest Protocol

Get credit tiers for an entity

get

This endpoint allows users to retrieve the credit tiers for a specific entity.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/credits-tiers' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": [
    {
      "entityId": "text",
      "creditsTierId": "text",
      "creditsTierName": "text",
      "price": 1,
      "creditsAmount": 1,
      "recurringTimePeriod": "text",
      "extraCreditsAmount": 1
    }
  ]
}

Successful response

get Credit tiers

get

This endpoint retrieves credit tiers of an entity.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/credits' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": {
    "entityId": "abc123",
    "userId": "user1",
    "creditsAmount": 100,
    "history": [
      {
        "creditsAmount": 50,
        "createdAt": "2023-07-21T12:34:56Z",
        "type": "BOUGHT",
        "reason": "Purchase of product XYZ"
      }
    ]
  }
}

Successful response

Get credit info for a user

get

Retrieve the credit information for a user.

Path parameters

userIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/users/{userId}/credits' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": {
    "entityId": "abc123",
    "userId": "user1",
    "creditsAmount": 100,
    "history": [
      {
        "creditsAmount": 50,
        "createdAt": "2023-07-21T12:34:56Z",
        "type": "BOUGHT",
        "reason": "Purchase of product XYZ"
      }
    ]
  }
}

Successful response

get Credit tiers for user

get

This endpoint retrieves credit tiers for user of an entity.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/user-credits' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token'

200

400

401

500

{
  "success": true,
  "data": {
    "entityId": "abc123",
    "userId": "user1",
    "creditsAmount": 100,
    "history": [
      {
        "creditsAmount": 50,
        "createdAt": "2023-07-21T12:34:56Z",
        "type": "BOUGHT",
        "reason": "Purchase of product XYZ"
      }
    ]
  }
}

Successful response

Make payment

post

This endpoint allows to make payment.

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

idstringrequired

Example: stripe-payment-method-id

productobjectrequired

cardDataobjectrequired

infoobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/payment/pay' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "stripe-payment-method-id",
    "product": {
      "price": 100
    },
    "cardData": {
      "email": "[email protected]",
      "name": "Jon Doe",
      "country": "India",
      "zip": 12020
    },
    "info": {
      "userId": "u-1202",
      "entityId": "e-0000000000"
    }
  }'

200

400

500

{
  "success": true,
  "data": {}
}

Successful response

Create payment intent for an entity

post

This endpoint allows users to create a payment intent for an entity.

Path parameters

entityIdstringrequired

userIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

cardDataobjectoptional

intentDataobjectoptional

forEntityIdstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/users/{userId}/create-payment-intent' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "cardData": {
      "email": "[email protected]",
      "name": "text",
      "address": "text"
    },
    "intentData": {
      "paymentMethodId": "text",
      "amount": 1,
      "currency": "text"
    },
    "forEntityId": "text"
  }'

200

400

401

500

{
  "success": true,
  "data": {
    "clientSecret": "text",
    "intentId": "text"
  }
}

Successful response

Approve payment for an entity

post

This endpoint allows users to approve a payment for an entity.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

intentIdstringrequired

The ID of the payment intent to approve.

Example: pi_123456789

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/approve-payment' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "intentId": "pi_123456789"
  }'

200

400

401

500

{
  "success": true
}

Successful response

Add credit tier for an entity

post

This endpoint allows the entity owner to add a new credit tier.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

creditsAmountnumberoptional

The amount of credits in the tier.

extraCreditsAmountnumberoptional

The amount of extra bonus credits.

pricenumberoptional

The price of the credit tier.

creditsTierIdstringoptional

The ID of the credit tier.

creditsTierNamestringoptional

The name of the credit tier.

recurringTimePeriodstring · enum · default: "ONETIME"optional

The recurring time period for the credit tier.

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/credits-tiers' \
  --header 'apikey: test' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "creditsAmount": 1,
    "extraCreditsAmount": 1,
    "price": 1,
    "creditsTierId": "text",
    "creditsTierName": "text",
    "recurringTimePeriod": "MONTHLY"
  }'

200

400

500

{
  "success": true,
  "data": {
    "creditsTierId": "text",
    "creditsTierName": "text"
  }
}

Successful response

Update credit tier for an entity

patch

This endpoint allows the entity owner to update an existing credit tier.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

creditsAmountnumberoptional

The updated amount of credits in the tier.

extraCreditsAmountnumberoptional

The updated amount of extra bonus credits.

pricenumberoptional

The updated price of the credit tier.

creditsTierIdstringoptional

The ID of the credit tier to update.

creditsTierNamestringoptional

The updated name of the credit tier.

recurringTimePeriodstring · enumoptional

The updated recurring time period for the credit tier.

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PATCH \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/credits-tiers' \
  --header 'apikey: test' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "creditsAmount": 1,
    "extraCreditsAmount": 1,
    "price": 1,
    "creditsTierId": "text",
    "creditsTierName": "text",
    "recurringTimePeriod": "MONTHLY"
  }'

200

400

500

{
  "success": true,
  "data": {
    "creditsTierId": "text",
    "creditsTierName": "text",
    "creditsAmount": 1,
    "price": 1,
    "extraCreditsAmount": 1,
    "recurringTimePeriod": "text"
  }
}

Successful response

Buy credits for a user

post

Purchase credits for a user in a specific entity.

Path parameters

userIdstringrequired

Query parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

creditsTierIdstringoptional

intentIdstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/users/{userId}/buy-credits?entityId=text' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "creditsTierId": "text",
    "intentId": "text"
  }'

200

400

401

500

{
  "success": true
}

Successful response

Decrement credits for a user

post

Decrement credits for a user in a specific entity.

Path parameters

userIdstringrequired

Query parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

creditsAmountnumberoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/users/{userId}/decrement-credits?entityId=text' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "creditsAmount": 1
  }'

200

400

500

{
  "success": true
}

Successful response

Buy credits for an entity

post

Buy credits for a user in a specific entity.

Path parameters

entityIdstringrequired

Query parameters

userIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

creditsTierIdstringoptional

intentIdstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/buy-credits?userId=text' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "creditsTierId": "text",
    "intentId": "text"
  }'

200

400

500

{
  "success": true
}

Successful response

Decrement credits for an entity

post

Decrement credits for a user in a specific entity.

Path parameters

entityIdstringrequired

Header parameters

apikeystringrequired

The API key for authentication

Example: test

apisecretstringoptional

The secret key for authentication

Example: test-secret

useridstringrequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringrequired

The token for user authentication.

Example: dummy-token

Body

userIdstringoptional

creditsAmountnumberoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.questprotocol.xyz/api/entities/{entityId}/decrement-credits' \
  --header 'apikey: test' \
  --header 'userid: dummy-userid' \
  --header 'token: dummy-token' \
  --header 'Content-Type: application/json' \
  --data '{
    "userId": "text",
    "creditsAmount": 1
  }'

200

400

500

{
  "success": true
}

Successful response

Get credit tiers for an entity

get Credit tiers

Get credit info for a user

get Credit tiers for user

Make payment

Show child attributes

Show child attributes

Show child attributes

Create payment intent for an entity

Show child attributes

Show child attributes

Approve payment for an entity

Add credit tier for an entity

Update credit tier for an entity

Buy credits for a user

Decrement credits for a user

Buy credits for an entity

Decrement credits for an entity