Subscription plans

A recurring USDC billing plan your customers subscribe to.

List your subscription plans

GET /api/v1/subscriptions

Scope: read. Priced as a read call.

Create a subscription plan

POST /api/v1/subscriptions

Scope: write. Priced as subscription_create ($0.01 once your monthly quota is used up).

Field	Type	Required	Notes
name	string	yes	3–100 chars
amount_usdc	number	yes	Positive, up to 1,000,000
interval_days	number	yes	One of 7, 14, 30, 90, 180, 365
destination_wallet	string	yes	Wallet that receives each recurring payment
on_chain_plan_id	number	yes	Integer ID you assign — must match what you registered on the VeltroSubscriptionHub contract
description	string	no	Max 500 chars

curl -X POST https://veltro.online/api/v1/subscriptions \
  -H "Authorization: Bearer vltro_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro membership",
    "amount_usdc": 20,
    "interval_days": 30,
    "destination_wallet": "0xYourWalletAddress",
    "on_chain_plan_id": 1
  }'

{
  "data": {
    "id": "...",
    "on_chain_plan_id": 1,
    "name": "Pro membership",
    "amount_usdc": 20,
    "interval_days": 30,
    "status": "active",
    "created_at": "..."
  }
}

Subscribers pull each renewal themselves by signing against the VeltroSubscriptionHub contract — Veltro never signs or holds a recurring authorization on your behalf.