Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nevermined.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Making Purchases

Complete guide to ordering payment plans and managing credits with the Nevermined CLI.

​
Overview

Purchasing a payment plan gives you access to AI agents and services. Once you order a plan, you receive credits or time-based access that you can use to query agents.

​
Ordering a Plan

​
Crypto Payment

Purchase a payment plan with cryptocurrency: 
nvm plans order-plan <plan-id>
Example: 
nvm plans order-plan "did:nvm:abc123"
Output: 
Plan Order Success
Plan ID: did:nvm:abc123
Credits Purchased: 100
Transaction Hash: 0x1234567890abcdef...
Status: Confirmed

​
Fiat Payment

Initiate a plan purchase with fiat. This returns a URL where you can complete the payment: 
nvm plans order-fiat-plan <plan-id>
Example: 
nvm plans order-fiat-plan "did:nvm:abc123"

​
Checking Your Credits

​
View Plan Balance

Check how many credits you have remaining: 
# Your balance
nvm plans get-plan-balance <plan-id>

# Balance for specific address
nvm plans get-plan-balance <plan-id> --account-address "0x123..."
Example output: 
Plan Balance
Plan ID: did:nvm:abc123
Credits Remaining: 75

​
Monitor Multiple Plans

Check balances for all your plans: 
#!/bin/bash
PLANS=("did:nvm:plan1" "did:nvm:plan2" "did:nvm:plan3")

for PLAN in "${PLANS[@]}"; do
  echo "Checking balance for $PLAN..."
  nvm plans get-plan-balance $PLAN
  echo ""
done

​
Refilling Credits

​
Purchase Additional Credits

Re-order a plan to add more credits to your existing balance: 
nvm plans order-plan <plan-id>

​
Bulk Credit Purchase

Order multiple plans at once: 
#!/bin/bash
PLANS=("did:nvm:plan1" "did:nvm:plan2")

for PLAN in "${PLANS[@]}"; do
  echo "Ordering $PLAN..."
  nvm plans order-plan $PLAN
done

​
Credit Usage

​
Set Up Balance Monitoring

Create a script to alert when credits run low: 
#!/bin/bash
PLAN_ID="did:nvm:abc123"
MIN_CREDITS=10

BALANCE=$(nvm plans get-plan-balance $PLAN_ID --format json | jq -r '.balance')

if [ "$BALANCE" -lt "$MIN_CREDITS" ]; then
  echo "LOW CREDITS ALERT"
  echo "Plan: $PLAN_ID"
  echo "Remaining: $BALANCE credits"
fi

​
Auto-Refill Script

Automatically refill credits when low: 
#!/bin/bash
# Run as cron job: 0 */6 * * * /path/to/auto-refill.sh

PLAN_ID="did:nvm:abc123"
MIN_CREDITS=20

BALANCE=$(nvm plans get-plan-balance $PLAN_ID --format json | jq -r '.balance')

if [ "$BALANCE" -lt "$MIN_CREDITS" ]; then
  echo "$(date): Credits low ($BALANCE), ordering more..."
  nvm plans order-plan $PLAN_ID

  if [ $? -eq 0 ]; then
    NEW_BALANCE=$(nvm plans get-plan-balance $PLAN_ID --format json | jq -r '.balance')
    echo "$(date): New balance: $NEW_BALANCE credits"
  else
    echo "$(date): ERROR - Failed to order credits"
  fi
else
  echo "$(date): Balance healthy: $BALANCE credits"
fi

​
Examples

​
Example 1: Complete Purchase Flow

#!/bin/bash

# 1. Browse available plans
echo "Available Plans:"
nvm plans get-plans

# 2. Get details about a specific plan
PLAN_ID="did:nvm:abc123"
nvm plans get-plan $PLAN_ID

# 3. Check current balance
echo "Current balance:"
nvm plans get-plan-balance $PLAN_ID

# 4. Purchase the plan
echo "Purchasing plan..."
nvm plans order-plan $PLAN_ID

# 5. Verify purchase
echo "New balance:"
nvm plans get-plan-balance $PLAN_ID

# 6. Get access token for using the service
echo "Getting access token..."
nvm x402token get-x402-access-token $PLAN_ID

​
Example 2: Team Credit Management

#!/bin/bash
TEAM_PLANS=("did:nvm:plan1" "did:nvm:plan2" "did:nvm:plan3")

# Purchase for entire team
for PLAN in "${TEAM_PLANS[@]}"; do
  echo "Ordering $PLAN for team..."
  nvm plans order-plan $PLAN
done

# Generate team usage report
echo "Team Balances:"
for PLAN in "${TEAM_PLANS[@]}"; do
  nvm plans get-plan-balance $PLAN --format json | jq '{plan: .planId, remaining: .balance}'
done

​
Best Practices

​
1. Monitor Credit Levels

Set up monitoring to avoid service interruptions: 
# Daily cron job
0 9 * * * /path/to/check-credits.sh

​
2. Plan Ahead

Purchase credits before you need them to avoid delays.

​
3. Use Automation

Implement auto-refill to ensure continuous service: 
# Check every 6 hours
0 */6 * * * /path/to/auto-refill.sh

​
4. Use JSON Output for Scripting

Always use --format json in scripts: 
BALANCE=$(nvm plans get-plan-balance $PLAN_ID --format json | jq -r '.balance')

​
Common Issues

​
”Insufficient funds”

Ensure your wallet has enough balance for crypto payments.

​
”Plan not available”

The plan may be sold out or no longer active: 
# Verify plan status
nvm plans get-plan <plan-id>

# Look for alternative plans
nvm plans get-plans

​
Next Steps

  • Querying - Use your credits to query agents
  • Plans - Learn about different plan types
  • Agents - Discover available agents