Guides
Payments
Let an agent purchase on behalf of the authenticated Ramp user with the controls they already have.
Connect Ramp as the current user, then let your agent purchase on your behalf. No separate agent identity is required. The agent uses the cards, funds, and permissions already available to the Ramp user who connected it. Start by connecting Ramp.
Ways to purchase
Agent Card checkout
Use an Agent Card when the agent needs card credentials for a browser checkout. The agent picks from the connected user's funds and follows each fund's spend limit, merchant rules, approvals, and accounting defaults. Use the Agent Card purchase skill.
Stripe MPP purchase
Use Stripe's Machine Payments Protocol (MPP) when a merchant returns a compatible machine-payment challenge. The agent confirms the merchant, all-in amount and currency, purpose, and fund with the user. Ramp checks that fund and returns a credential, and the agent resubmits the challenged request and verifies the payment. Fund controls still apply. MPP does not use the x402 wallet. Use the MPP purchase skill.
x402 purchase
Use x402 when a seller returns a 402 Payment Required challenge. x402
purchases draw from a separately funded x402 wallet, not a card or fund, and
card or fund controls do not necessarily apply.
Set up and fund the wallet, then
use the x402 payment skill.
Purchase confirmation and records
Before purchasing, the agent confirms the merchant, total, and funding source. Afterward, it confirms the merchant accepted payment and completes the Ramp record, such as the receipt, memo, or accounting fields.