Developer Feature

Accept payments from customers and AI agents. One integration.

Add DropPay to your checkout once. Customers pay through the pay page. AI agents pay the same way, programmatically. Same webhook, same dashboard, no extra work.

AI agent payments

How agent payments work through your checkout.

Your server creates one payment request. Customers pay through the DropPay pay page. AI agents pay the same way, programmatically. Same webhook fires either way.

1

Your server creates a payment request

One API call returns a request ID, wallet address, XRP amount, and destination tag.

2

Your server returns payment details to the agent

Wallet address, destination tag, XRP amount, and verify URL. The agent reads these directly - no redirect, no UI required.

3

Agent sends XRP directly on-chain

Funds go straight to your wallet on the XRP Ledger. DropPay never holds them. Settles in seconds.

4

Agent verifies. Webhook fires.

The agent posts the transaction hash. DropPay confirms it on-chain and fires your webhook - the same webhook your human checkout already uses.

droppay-mcp is the MCP server AI agents use to pay DropPay checkouts. Install it in Claude Code, Cursor, or any MCP client and your agent can run this flow automatically - no extra code needed. Install guide

Read the checkout docs

Merchant - protect your endpoint

from droppay import x402_guard

@app.get("/products/report-q2/download")
@x402_guard(amount=4.99, currency="USD")
async def download_report():
    return FileResponse("report-q2.pdf")

Agent / client - standard 402 flow

# 1. Agent hits the endpoint
r = GET /products/report-q2/download
    → 402 + wallet + amount

# 2. Agent pays on-chain
tx = send_xrp(wallet, r.amount, r.wallet)

# 3. Agent retries with proof
GET /products/report-q2/download
  X-Payment-Hash: {tx.hash}
  → 200 + file delivered

The most elegant approach for agent-facing APIs.

Wrap any endpoint with x402 middleware and it becomes self-describing. The agent hits it, learns what it costs and how to pay, pays, and gets the response - with no separate catalog, no pre-created payment request, and no human in the loop.

Charge per API call

Bill AI clients per request with no signup or billing account required.

Gate data, files, and reports

Pricing is per endpoint. Set different prices for different products without a catalog step.

Agent-to-agent services

Any agent that understands HTTP 402 can pay your endpoint. No pre-registration needed.

One integration, both payers

Human customers and AI agents go through the same payment request and fire the same webhook. No separate code path to maintain.

Non-custodial by design

Funds go directly to your wallet on the XRP Ledger. DropPay never holds them at any point.

Settles in seconds

XRP confirms in 3 to 5 seconds. No clearing windows, no holds, no waiting for funds to arrive.

Common questions.

Do I need a separate integration for AI agents?
No. Your server creates the same payment request whether the payer is a human or an agent. The same webhook fires when payment confirms. You do not write separate code for agent customers.
What is the difference between the checkout flow and x402?
The checkout flow requires your server to create a payment request upfront and return the details to the agent. x402 is more direct - the agent hits your endpoint, receives a 402 with payment instructions, pays, and retries. x402 is the more elegant approach for agent-facing APIs because the endpoint is self-describing.
How is payment verified before my server delivers anything?
When the agent submits a transaction hash, DropPay queries the XRP Ledger directly to confirm the transaction is real, matches the expected amount, and was sent to your wallet. Your webhook only fires after on-chain confirmation.
Does the agent need a DropPay account?
No. The agent only needs a funded XRP wallet. No account, no signup, no OAuth. DropPay is only required on the merchant side.
Do I need a paid plan?
AI agent payments, webhooks, and API access require a Pro plan. You can start free and upgrade to Pro - a 14-day trial is included.

Make your checkout agent-ready.

Free account. 14-day Pro trial. Up and running in under 10 minutes.