Skip to content
AllowKit Docs

Payment receiver flow

Receivers do not need to run AllowKit to get paid. AllowKit maps a human-readable service id, like risk-report-api, to a registered Solana recipient address. The agent pays by service id; policy verifies that id and address before the escrow releases funds.

Register

A service gets a stable service id and one or more Solana recipient addresses.

Approve

The user adds that service id to an agent policy. Unknown service ids and changed addresses are blocked.

Request

The agent calls allowkit.pay({ service, amount, reason }). AllowKit resolves the recipient from the registry.

Settle

Approved payments settle as normal Solana transfers. Receivers can optionally verify signed webhooks or payment references.

service.json
{
  "id": "risk-report-api",
  "name": "Risk Report API",
  "recipient": "solana:8qZ...F2p",
  "asset": "USDC",
  "webhookUrl": "https://risk.example/webhooks/allowkit"
}