ramp-setup-x402-wallet

Provision and fund a Ramp x402 Solana wallet from a Ramp Checking account.

2|1|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/ramp-public/skills --skill ramp-setup-x402-wallet-ramp-public
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ramp-setup-x402-wallet
Source: https://github.com/ramp-public/skills/tree/main/plugins/ramp/skills/ramp-setup-x402-wallet
Command: npx skills add https://github.com/ramp-public/skills --skill ramp-setup-x402-wallet-ramp-public

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up an x402 wallet for agentic payments requires provisioning a business Solana wallet and funding it from a corporate checking account, a multi-step process involving authentication, account eligibility checks, irreversible transfers, and approval workflows that are easy to get wrong without guided instructions. ## Core Features & Use Cases - Guided Wallet Provisioning: Walks an owner or admin through connecting the Ramp CLI or MCP tools and creating the company's Ramp-managed x402 wallet on Solana with explicit confirmation. - Safe Funding Workflow: Lists eligible Ramp Checking accounts (active, USD, Increase-provided, sufficient balance), enforces a $1 minimum, and executes funding with a unique idempotency key per transfer. - Approval and Settlement Monitoring: Detects pending withdrawal approvals, directs the approver to the correct Ramp page, and polls transfer status every 15 seconds for up to 15 minutes until settlement. - Use Case: A finance admin wants to enable agentic commerce for their company. The agent verifies their role, provisions the x402 wallet, helps them pick a funded Ramp Checking account, transfers $500, monitors the transfer to completion, and hands off to the payment skill. ## Quick Start Ask the agent to set up and fund a Ramp x402 wallet from your Ramp Checking account, then follow its confirmation prompts.

Frequently Asked Questions about ramp-setup-x402-wallet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Ramp x402 wallet?

Connect an up-to-date Ramp CLI or Ramp MCP connection, authenticate via browser OAuth, then confirm provisioning as an owner or admin. The agent calls x402 create, which returns a wallet address with sign_ready status, and repeated calls return the same wallet.

How do I fund an x402 wallet from Ramp Checking?

Select an active, USD-denominated Ramp Checking account provided by Increase with sufficient available balance, confirm the exact amount (minimum $1), and the agent calls x402 fund with a unique idempotency key. Settlement may take up to 15 minutes and is monitored automatically.

What permissions are required to provision an x402 wallet on Ramp?

You must be an owner or admin of the company's Ramp account with Ramp Checking access. You also need an up-to-date Ramp CLI or MCP connection, Python 3, and browser access for OAuth and any required withdrawal approval.

What happens if the x402 funding call times out?

The agent does not retry with the same idempotency key. It searches treasury transfers for an entry whose UUID matches the idempotency key to reconcile the outcome, and stops to report the uncertain state if no exact match is found.

Does x402 wallet funding require a withdrawal approval?

It can, depending on the Ramp Checking account's approval settings. The agent checks the transfer status and directs the assigned approver to the account's pending-approvals page in Ramp; it never approves on the user's behalf.

When should I use ramp-make-x402-payment instead of wallet setup?

Use ramp-make-x402-payment when the x402 wallet is already provisioned and funded and you want to execute a specific x402 purchase. The setup skill is only for enabling, provisioning, and funding the wallet itself.