Release date: 2026-06-07
Current version: v0.5.0
These notes cover what is new in AgentPay SDK v0.5.0.
Release summary
AgentPay SDK v0.5.0 adds a Fiat payment path through Stripe Link. Users can now bind a Link account during install or later with agentpay link onboard, approve each agent purchase in Link, and let the agent receive one-time card credentials only after that approval. The existing Crypto wallet path remains available through agentpay admin setup.
What's new in v0.5.0
Fiat payment setup with Link
- added
agentpay link onboardto bind the user's Link account using the bundled Stripe Link CLI - added
agentpay link status --jsonto check whether the local Link auth state is reusable - added
agentpay link payment-methods --jsonto list saved Link payment methods after onboarding - added
agentpay link cardto create a Link spend request, request user approval in Link, poll for approval, and write one-time card credentials to a private local file
Installer payment choice
- added an install-time payment setup choice: Fiat with Link, Crypto with the local wallet, or later
- added
AGENTPAY_SETUP_PAYMENT_METHOD=fiat,crypto, ornonefor non-interactive installers - preserved
AGENTPAY_SETUP_RUN_ADMIN_SETUP=yesas a legacy alias for the Crypto wallet setup path - kept skills-only installs separate from payment setup so third-party agents can install adapters without configuring a wallet or Link account immediately
Third-party agent integration
- added the
@worldlibertyfinancial/agentpay-sdk/linksubpath export for programmatic Link integration - exposed helper functions for onboarding, status checks, payment-method listing, Link CLI passthrough, and approved card creation
- bundled
@stripe/link-cliso third-party agents do not need a separate Link CLI installation - added
agentpay link install --jsonto show the available CLI, SDK, and MCP entrypoints for integrators
Skill and documentation updates
- updated the AgentPay skill pack and adapters for Codex, Claude, Gemini, Cline, Copilot, Cursor, and OpenAI-style skill manifests
- documented the Fiat Link flow separately from the Crypto wallet flow
- documented the developer tarball distribution path for third-party agents using
@worldlibertyfinancial/agentpay-sdk/link - added explicit secure-handling guidance: never paste Link tokens, card numbers, CVCs, or full card credential files into chat or logs
- documented the distribution boundary for package consumers: ship a built package or installer bundle so
@worldlibertyfinancial/agentpay-sdk/linkresolves todist/link.cjs
Compatibility and operational notes
- Link Fiat payments require user approval in Link before card credentials are retrieved.
- Full card credentials are written to a local file and should be handled as secrets.
- The Crypto wallet path is unchanged and remains available through
agentpay admin setup. - Source installs must run
npm run buildbefore consumers import@worldlibertyfinancial/agentpay-sdk/link.
Documentation
For command usage and operator workflows, see:
- README.md
agentpay --helpagentpay link --helpagentpay link onboard --helpagentpay link card --help