Payment links

A payment link is a hosted USDC checkout page (veltro.online/pay/{slug}) for a fixed amount.

List your payment links

GET /api/v1/payment-links

Scope: read. Priced as a read call.

curl https://veltro.online/api/v1/payment-links \
  -H "Authorization: Bearer vltro_live_xxx"

{ "data": [ { "id": "...", "slug": "abc123", "amount_usd": 100, "destination_address": "0x...", "status": "active", "created_at": "..." } ] }

Create a payment link

POST /api/v1/payment-links

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

Field	Type	Required	Notes
amount_usd	number	yes	Must be positive
description	string	no
destination_address	string	yes	The wallet that receives the USDC
expires_in_days	number	no	1–365

curl -X POST https://veltro.online/api/v1/payment-links \
  -H "Authorization: Bearer vltro_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_usd": 250,
    "description": "Design retainer — March",
    "destination_address": "0xYourWalletAddress",
    "expires_in_days": 30
  }'

{
  "data": {
    "id": "...",
    "slug": "xK2p9qLmZ1",
    "amount_usd": 250,
    "destination_address": "0x...",
    "url": "https://veltro.online/pay/xK2p9qLmZ1",
    "status": "active",
    "created_at": "..."
  }
}

Share data.url with your customer — they connect a wallet and pay from that page. Veltro never holds the funds; they route directly from payer to destination_address on-chain, minus the plan's transaction fee.