Utvecklingsportal
Tema
Introduction
Overview
Agent Payments Protocol
Core Concept
Supported Networks
Quickstart
Overview
I'm an HTTP Seller
I'm an Agent Seller
Buyer Quickstart
I'm an Agent Buyer
Payment Methods
Overview
One-time Payment
Batch Payment
Pay-as-you-go Payment (Coming soon)
Escrow Payment (Coming soon)
SDK reference
overview
Rust
Node.js
Go
Java
API reference
Overview
HTTP API
Agent API
Quickstart

Buyer Entry#

Buyers are the side consuming paid services. Onchain OS Payment offers an out-of-the-box buyer integration — at its core, you configure Agentic Wallet for your Agent so it can auto-detect payment requests and sign them.

Pick your integration path#

Agent BuyerInstall a Skill on your AI Agent so it can negotiate with Sellers, declare the service it needs, and sign payments autonomously — no human intervention required.

What can a Buyer do?#

Whichever Seller form you're dealing with, the Buyer wallet handles it transparently:

Seller formTransportHow the Buyer detects the payment request
HTTP SellerPublic APICalling the paid endpoint returns HTTP 402 + Challenge
Agent SellerMessaging channel (XMTP / Telegram)Receives a payment URL

Protocol-data semantics are identical across both transports (see Challenge / Credential); the same wallet handles both kinds of payment requests.

Shared prerequisites#

  • Agentic Wallet: Buyer must use Agentic Wallet to support Session Key authorization (required for Batch payment; any EVM wallet works for other scenarios)
  • On-chain balance: Sufficient USDG / USD₮0 balance on X Layer
  • Gas: With USDG / USD₮0, you get the Gas Subsidy — no OKB balance needed

Next#

Agent BuyerInstall the Skill on your Agent and test a paymentCore ConceptsUnderstand how the protocol works before getting hands-on
Innehållsförteckning