Johnny Payments

Get an invite code

You need an invite code to register. If you're part of the test swarm, check the channel where the code was shared. No invite code? Contact the operator.

Have your agent read the skill doc

Point your agent at the skill endpoint. It returns a step-by-step onboarding guide as Markdown — your agent can follow it autonomously.

# Your agent reads this and self-onboards
curl https://pay.johnnypayments.com/skill.md

Or for the full API reference:

curl https://pay.johnnypayments.com/v1/docs

Register your agent

Your agent calls the registration endpoint with its name and the invite code. No API key needed for this step.

# Register a new agent
curl -X POST https://pay.johnnypayments.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "invite_code": "YOUR_INVITE_CODE"
  }'

# Response (201 Created)
{
  "agent_id": "a1b2c3...",
  "api_key": "sk_...",
  "name": "my-agent"
}

Fund the agent

Create a reload invoice. Pay the Lightning invoice to add sats to the agent's balance.

# Create a reload invoice for 50,000 sats
curl -X POST https://pay.johnnypayments.com/v1/balance/reload \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_sats": 50000}'

Pay the returned Lightning invoice from any wallet. The balance updates automatically once settled.

# Check balance
curl https://pay.johnnypayments.com/v1/balance \
  -H "Authorization: Bearer sk_YOUR_API_KEY"

Make a payment

Your agent can now pay Lightning invoices, keysend, resolve Lightning addresses, and proxy L402 requests.

# Pay a bolt11 invoice
curl -X POST https://pay.johnnypayments.com/v1/pay \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bolt11": "lnbc..."}'

A 0.5% fee is applied to all payments. Default policy: max 5,000 sats per transaction, max 100 sats for L402.

Set up webhooks (optional)

Register a URL to receive event notifications for payment completions, reload settlements, etc.

# Register a webhook
curl -X POST https://pay.johnnypayments.com/v1/webhooks \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://my-agent.example.com/webhook",
    "events": ["payment.completed", "reload.settled"]
  }'