ramp-make-x402-payment

Make and verify x402 payments from a funded Ramp Solana wallet.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing x402 payments requires safely handling untrusted 402 challenges, signing with a funded wallet, and verifying on-chain settlement, which is error-prone when done manually. ## Core Features & Use Cases - Guided x402 payment flow: Fetch and validate a 402 Payment Required challenge, confirm the exact amount with the user, sign via the Ramp x402 pay tool, and retry the request with the payment header. - Merchant discovery: Use Exa Search as the default demo merchant or browse the official x402 Bazaar for compatible Solana mainnet USDC services. - Settlement verification: Decode the PAYMENT-RESPONSE header and produce a Solscan transaction link as proof of payment. - Use Case: Ask your agent to pay for an Exa web search via x402 from your Ramp wallet; it checks your USDC balance, shows the exact charge, signs only after your confirmation, and returns the search results plus a Solscan receipt. ## Quick Start Ask your agent to make a small test x402 payment to Exa Search using your funded Ramp x402 wallet and confirm the quoted amount when prompted.

Frequently Asked Questions about ramp-make-x402-payment

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

FAQPage Schema
How do I make a test x402 payment with a Ramp wallet?

Use the Ramp x402 pay tool to sign a validated 402 challenge after confirming the exact merchant, amount, and recipient. The flow fetches the challenge, persists the selected accepts entry, signs once, and retries the request with the PAYMENT-SIGNATURE header.

How do I pay an x402-protected API like Exa Search?

Send an unpaid POST request to https://api.exa.ai/search without an API key, decode the PAYMENT-REQUIRED header, select the compatible Solana USDC entry, sign with Ramp, then retry the identical request with the payment header.

What x402 payment schemes does Ramp support?

Ramp currently supports only the fixed-price exact scheme on Solana mainnet with canonical USDC. EVM, Base, testnet, dynamic-price, and non-USDC challenge entries must be rejected rather than modified.

Can I discover other x402 merchants besides Exa?

Yes, query the official x402 Bazaar discovery endpoint such as the Coinbase CDP facilitator and filter for exact-scheme Solana mainnet USDC entries. Discovered URLs must be validated and pinned to a public IP before any request.

Why did my x402 payment retry fail after signing?

A failed retry is not permission to sign again; show the error and ask the user before fetching a fresh challenge. Each signing attempt needs its own idempotency key tied to that exact challenge.

What do I need before making an x402 payment?

You need a provisioned and funded Ramp x402 wallet, Ramp CLI or MCP access to the x402 pay tool, Python 3, curl, jq, and network access to the merchant, Solana RPC, and Solscan. If the wallet is not set up, use the ramp-setup-x402-wallet skill first.