P89Paygate89

X402 LOCATION CONTRACT API · JAPAN · PREVIEW

AIエージェントが、
日本の住所契約を完了する。

Paygate89は、AIエージェントが日本国内の拠点と1〜65535階の仮想フロアを選び、x402 v2で支払い、30日間の郵便受取住所契約を取得するAPIです。

OpenAPIを読むMCPを接続API catalog

Preview: Solana Devnet上のテスト環境です。Devnet USDCに金銭価値はなく、実際の郵便取扱いを開始するにはオーナーのKYCと転送先登録が必要です。

VERIFIED SERVICE FACTS

判断に必要な情報

PRICE55 USDC

1拠点・1フロア・30日間。金額はPayment Intentをサーバーが固定します。

PAYMENTx402 v2 exact

Solana Devnet。外部ウォレットを使い、秘密鍵をPaygate89へ渡しません。

DISCLOSURE決済後のみ

決済前はエリア概要だけを公開し、正確な日英住所はsettlement後に返します。

FLOORS1〜65535階

未契約の階を選択します。Intent予約中または他者が契約中の階は選択できません。

CONTRACT FLOW

エージェントの実行手順

  1. 01
    拠点と階を選ぶ

    GET /v1/locationsで候補を比較し、GET /v1/locations/{locationId}/floors/{floor}で1〜65535階の選択可否を確認します。

  2. 02
    Payment Intentを作成

    POST /v1/payment-intentsへlocationIdとfloorを送ります。選択階は15分間予約されます。

  3. 03
    x402で支払う

    返されたpayPathをx402対応clientで呼び、challengeを検証して決済します。

  4. 04
    住所と階の契約を受け取る

    settlement後、30日間の権利、選択階、スナップショットされた日本語・英語住所を受け取ります。

  5. 05
    オーナーが利用準備

    オーナー専用KYC画面で本人確認と転送先登録を完了します。

MODEL CONTEXT PROTOCOL

MCPから直接操作できる

https://agent.chain.tokyo/mcpでMCP 2026-07-28のstateless HTTP endpointを提供します。RESTと同じPreview Bearer tokenとowner IDをheaderへ設定します。

MCP server: https://agent.chain.tokyo/mcp
Authorization: Bearer <preview_agent_token>
X-Paygate-Owner-Id: <owner-id>

tools:
  list_locations
  get_floor_availability
  create_payment_intent
  list_contracts

Payment Intent作成は階を15分間予約しますが、MCPサーバーはウォレット署名を行いません。返されたx402 payment URLを外部ウォレット対応clientで支払います。KYC、転送先変更、admin操作はAgent向けMCP toolではありません。

MACHINE DISCOVERY

APIとして発見できる

OpenAPI 3.1、IETF RFC 9727 API catalog、MCP endpointを公開しています。すべての業務requestにはPreview Bearer tokenとowner IDが必要です。

Authorization: Bearer <preview_agent_token>
X-Paygate-Owner-Id: <owner-id>

GET  /v1/locations
GET  /v1/locations/{locationId}/floors/{floor}
POST /v1/payment-intents  { locationId, floor }

DIRECT ANSWERS

よくある質問

55 USDCで何を購入できますか？

選択した日本国内の1拠点・1フロアについて、30日間の住所契約を購入できます。PreviewのDevnet USDCには金銭価値がありません。

どの階を選べますか？

1〜65535の整数階を選べます。他のPayment Intentが予約中の階、または他の有効な契約が使用中の階は選択できません。現在の契約者は同じ階を更新できます。

支払い前にKYCは必要ですか？

必要ありません。ただし、実際の郵便取扱いを始める前に、Account OwnerのKYC承認と拠点ごとの転送先登録が必要です。

正確な住所は公開されていますか？

公開されません。決済前の拠点一覧にはエリア概要のみを載せ、正確な日本語・英語住所はsettlement後のresponseだけで開示します。

MCPから契約できますか？

Location一覧、階の空き確認、Payment Intent作成、契約一覧をMCP toolとして利用できます。実際のx402支払いは返されたURLを外部ウォレット対応clientで実行します。

本番サービスですか？

いいえ。現時点ではSolana Devnetと共有Preview tokenを使う検証環境です。実資金や本番データには使用できません。

ENGLISH SUMMARY

Japanese mailbox Location contracts for AI agents

Paygate89 lets an authenticated AI agent select a Japanese Location and one virtual floor from 1 through 65535, create a server-bound Payment Intent, settle a fixed 55 USDC x402 v2 payment on Solana Devnet, and receive a 30-day entitlement with the exact address, floor, and Japanese and English address text. Floors held by another active contract or intent reservation are unavailable. Payment is not identity evidence. The Account Owner must complete KYC and register a per-contract forwarding destination before physical mail handling.