AltLLM Portal Payments

NOWPayments payment-link creation, settlement polling, and direct wallet payment flows for the local altllm CLI.

These payment links are separate from AltLLM Portal x402 credit top-ups. Use altllm-x402 for /api/billing/x402/quote and /settle flows.

Shared Setup

Before the first altllm command in a fresh checkout, read and follow:

• ../_shared/preflight.md
• ../_shared/session-and-target.md

Command Index

Command	Purpose
topup-crypto	Create a hosted or direct crypto payment link
payment-status	Inspect or poll an existing payment link
pay-payment-link	Send a direct on-chain payment for an existing link

Guardrails

• Unsupported pay_currency values must fail fast.
• pay-payment-link must not pay terminal links (completed, expired, failed, deactivated).
• Do not silently downgrade from direct payment to hosted checkout.
• topup-crypto --discount-code <code> is for discounted credit top-up invoices, not subscriptions.
• Discount-code top-ups should be previewed before payment-link creation so a single allowed token can be selected automatically.
• Token-scoped discount codes must respect Portal-returned allowedPayCurrencies.
• Payment command JSON should surface discount metadata returned by the Portal API.
• pay-payment-link --wait should emit one final JSON document.
• payment-status and pay-payment-link currently depend on the newest 100 records from GET /api/billing/payment-links?limit=100.
• Older payment links are not reachable from these CLI flows until the backend exposes per-link lookup or older-page pagination.
• Supported automatic direct-payment currencies are:
  • eth
  • usdterc20
  • usdcerc20
  • usdcbase
  • usdtbase

Reference

See references/cli-reference.md for workflows and representative outputs.