人間ではない買い手のために設計。
CryptoPayInのすべての決済リンクおよびストアフロントは、機械可読なチェックアウトとしても機能します。 AIエージェントは販売内容を検出し、請求書を発行し、3回のHTTP呼び出しでオンチェーン決済まで完了します — ブラウザもAPIキーも、人の介在も不要です。納品まで含め、すべてJSON形式で行われます。
3回の呼び出しで、統合はすべて完了します。
任意のリンクを例に見てみましょう — たとえばhttps://cryptopaylink.co/pay/PL-XXXXXXX。
.jsonを付け加えるだけで、マシン向けのフローが始まります。以下の内容はすべて、今日時点であらゆるリンクで実際に動作しています。
販売内容、価格、対応資産、そして請求書発行の呼び出しに必要な項目までを自己記述的な形式で提供します。エージェントは事前に売り手についての知識を持つ必要がありません。
{
"protocol": "cpi-agent-checkout/1",
"link": {
"id": "PL-XXXXXXX", "state": "ok",
"title": "Pro license — 1 seat",
"pricing": { "currency": "USD", "type": "fixed", "amount": "12.00" },
"delivery": { "type": "keys", "description": "A unique key reserved for you…" }
},
"payment_assets": [ { "asset": "BTC", "network": "mainnet", "min_usd": "5.00" }, … ],
"checkout": { "create_invoice": { "method": "POST", "url": "…/invoice" }, … }
}
JSONボディは1つだけ — 資産の種類に加え、リンクが要求する項目(自由金額の場合は金額、バリエーション、
購入者情報の入力欄、実物商品の場合は配送先)を含めます。Idempotency-Keyヘッダーを送信すれば、再試行によって請求書が二重発行されることはありません。
curl -X POST https://cryptopaylink.co/pay/PL-XXXXXXX/invoice \
-H "Content-Type: application/json" \
-H "Idempotency-Key: agent-run-42" \
-d '{ "asset": "BTC", "fields": { "Discord username": "buyer#0001" } }'
{ "ok": true, "invoice": {
"payment": "P-XXXXXXXXXX",
"pay": { "asset": "BTC", "network": "mainnet",
"address": "bc1q…", "amount": "0.0001867",
"uri": "bitcoin:bc1q…?amount=0.0001867" },
"expires_at": "2026-07-20T11:00:25Z",
"receipt": "…/receipt?p=P-XXXXXXXXXX" } }
金額は正確で、レートも固定されています — エージェントは自ら管理するウォレットから、
pay.amountをpay.network上で送金するだけです。SDKも署名方式もファシリテーターも必要ありません。
数秒ごとにポーリングします。承認が進み、支払いが完了した瞬間に、レスポンスには 納品内容 — コンテンツ、リンク、あるいはその支払い専用に確保されたライセンスキー — が含まれます。
ショップも同じプロトコルに対応しています。 GET /s/SH-x.jsonはストアフロントの
カタログ全体(商品、バリエーション、在庫状況)を一覧表示し、1回のPOST /s/SH-x/orderでカートを支払い可能な
請求書に変換します — 受領確認は/s/SH-x/o/ORD-…/receiptで確認できます。
{ "ok": true, "receipt": {
"payment": "P-XXXXXXXXXX", "status": "completed",
"paid_at": "2026-07-20T10:30:58Z",
"delivery": { "type": "keys", "key": "LICENSE-XXXX-YYYY",
"note": "Delivered once, tied to this payment — store it now." },
"next": "done" } }
あえて地味な設計を貫いています
エージェントによる請求書発行も、ホスト型ページとまったく同じ検証・レート固定・アドレス導出のロジックを通ります — コードパスは1本のみで、乖離や悪用の余地となるような影の実装は存在しません。
エージェント用エンドポイントは、ページと同じレート制限のバケットおよび未処理請求書の上限を消費します。エージェント機能を有効にしても、アドレス枯渇やスパムのための余分な余地は一切増えません。
決済ドメインにはクッキーもセッションもCSRFの攻撃対象領域もありません。決済IDだけが唯一の権限であり、人間向けの受領確認URLとまったく同じです。
Idempotency-Keyヘッダーにより、請求書発行はリプレイに対して安全になります。同じキーで異なる内容を送信した場合は409で拒否されます。
エージェント決済はアカウントごとに設定でき、標準で有効になっています。オフにすると、マシン向けエンドポイントは403を返しますが、人間向けページはすべて通常どおり動作します。
人間向けページはLink: …/pay/PL-x.json; rel="alternate"を送信しており、この仕様は回答エンジン向けにllms.txtにも要約されています。
決済リンクで販売できるものは、すべて対応します
テキストコンテンツ、非公開URL、一度限りのライセンスキーなど — 受領確認のJSONで納品され、支払いごとに確保され、在庫上限下でも競合状態を起こしません。
法定通貨30種のいずれかによる固定価格、または売り手が定めた最小・最大額の範囲内での自由金額(チップ、請求書、チャージなど)に対応 — エージェントは"amount"を渡すだけです。
バリエーションごとの在庫を持つ商品バリエーションに加え、検出用ドキュメントで宣言されたカスタム必須項目(ユーザー名、注文メモなど)にも対応します。
請求書発行の呼び出しでは、配送先の国ごとに検証される構造化された配送先住所を受け付けます — エージェントも、箱に入って届く商品を注文できます。
GET /s/SH-x.jsonはショップのカタログ全体を在庫状況付きで公開し、1回のPOST …/orderでカートを検証し、在庫を確保したうえで請求書を返します。
エージェントに販売するのは買い手側の話です。リンクの作成、残高の確認、出金といった売り手側の仕組みを構築する場合は、加盟店向けREST APIをご利用ください。こちらも同様にスクリプトから操作できます。
エージェントに関する疑問へ、率直にお答えします
エージェントにAPIキーやアカウントは必要ですか?
いいえ、不要です。検出(ディスカバリー)、請求書発行、受領確認(レシート)は、いずれも1つの決済リンクに紐づく公開エンドポイントであり、人間向けの決済ページとまったく同じ仕組みです。発行時に返される決済IDが、エージェントが自身の受領確認を照会するために必要な唯一の資格情報です。加盟店向けのAPIキーは売り手のためのものであり、買い手には不要です。
エージェントは実際にどのように支払いますか?
請求書のレスポンスには、入金アドレス、正確な金額、そしてBIP-21形式のURIが含まれます。エージェントが管理するウォレット — BTCウォレット、EVM署名者、Solanaのキーペア、モネロウォレットなど — であれば、指定されたネットワーク上でその金額を送金するだけです。独自の署名方式を組み込む必要はありません。
これはx402ですか?
特定のプロトコルには依存しません。HTTPS呼び出しと暗号資産トランザクションのブロードキャストができるスタックであれば、どれでも支払いが可能です — ファシリテーターも専用ウォレットSDKも不要です。お使いのフレームワークがx402やAP2に対応している場合は、請求書呼び出しを決済ツールでラップしてください。JSONの契約仕様は402形式のフローに無理なく対応しており、ネイティブなx402ネゴシエーションも今後のロードマップに含まれています。
どのリンクやショップがエージェントで支払い可能ですか?
有効なすべての決済リンクと、有効なすべてのストアフロントが、標準で対応しています — 固定価格、自由金額、商品バリエーション、購入者情報の入力欄、配送を伴う実物商品、そして在庫情報付きのショップカタログ全体まで対応します。売り手は設定画面でアカウントごとにエージェント決済をオフにでき、その場合エンドポイントは403を返しますが、人間向けのページは通常どおり動作し続けます。
支払い後、エージェントは何を受け取りますか?
受領確認(レシート)用のエンドポイントは、支払いが完了した瞬間に、コンテンツ・非公開リンク・その支払い専用に確保されたライセンスキーなど、納品内容をJSON形式で返します。実物商品の注文の場合は、売り手が配送先住所を受け取ったことを確認できます。
悪意のあるエージェントがエンドポイントを悪用することはできますか?
エージェントによる呼び出しは、ホスト型の決済ページとまったく同じレート制限のバケット、請求書発行の上限、冪等性ルールを共有しており、追加の攻撃余地は一切生まれません。決済ドメインにはクッキーもセッションも存在しないため、クロスサイト呼び出しが便乗できる状態そのものが存在しません。