专为非人类买家打造。
每个 CryptoPayIn 支付链接及店铺,本身即是一套机器可读的结账系统。 AI 智能体通过三次 HTTP 调用即可发现您所售商品、创建发票并完成链上付款—— 无需浏览器,无需 API 密钥,也无需人工介入。交付内容以 JSON 形式一并提供。
三次调用,即是完整集成。
以任意支付链接为例——比如 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 请求体——填入资产类型,以及该链接所要求的其他信息(自由定价的金额、变体、
买家字段、实物商品的收货地址)。附上 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.network 上精确发送 pay.amount。无需 SDK,无需签名方案,无需 facilitator。
每隔几秒轮询一次。确认数会不断增加,付款完成的瞬间,响应中 即包含交付内容——具体内容、链接,或为该笔付款专门预留的许可证密钥。
店铺遵循相同的协议。 GET /s/SH-x.json 会列出店铺的
完整目录(商品、变体、实时库存);一次 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" } }
刻意求稳的工程
智能体发票经过与托管页面完全相同的校验、汇率锁定与地址推导——同一套代码路径,没有可能出现偏差或被利用的影子实现。
智能体接口与页面共用相同的速率限制与待处理发票上限。开启智能体功能不会为地址耗尽或垃圾请求增加任何额外空间。
支付域名上没有 cookie、没有会话,也不存在 CSRF 攻击面。支付 ID 是唯一凭证,与面向人类的收据链接完全一致。
Idempotency-Key 请求头使开票操作可安全重放;同一密钥搭配不同请求体会被拒绝,返回 409。
智能体结账按账户设置,默认开启。关闭后机器接口将返回 403,而所有面向人类的页面照常运作。
面向人类的页面会发送 Link: …/pay/PL-x.json; rel="alternate",该契约也在 llms.txt 中为回答引擎做了摘要说明。
支付链接能卖的一切
文本内容、私密链接、一次性许可证密钥——通过收据 JSON 交付,按每笔付款预留,在库存限制下也能安全应对并发。
可使用 30 种法币中的任意一种设定固定价格,也可设置由卖方定义最小/最大值的自由金额(打赏、发票、充值)——智能体只需传入 "amount"。
支持按变体设置库存的商品变体,以及在发现文档中声明的自定义必填字段(用户名、订单备注)。
开票调用接受结构化收货地址,并按目的地国家进行校验——智能体也能订购需要装箱寄送的商品。
GET /s/SH-x.json 会公开店铺的完整目录及实时库存;一次 POST …/order 即可校验购物车、预留库存并返回发票。
向智能体销售是买方视角。如果您要构建的是卖方功能——创建链接、查询余额、提现——那对应的是商户 REST API,同样完全可编程调用。
关于智能体的问题,直接解答
智能体是否需要 API 密钥或账户?
不需要。发现、创建发票与收据均为限定在单个支付链接范围内的公开接口——与面向人类的结账页面完全一致。创建时返回的支付 ID 是智能体查询自身收据所需的唯一凭证。商户 API 密钥面向卖方,而非买方。
智能体具体如何付款?
发票响应包含一个收款地址、一个精确金额以及一个 BIP-21 风格的 URI。智能体所控制的任意钱包——BTC 钱包、EVM 签名器、Solana 密钥对、Monero 钱包——只需在指定网络上发送该金额即可。无需接入任何专有签名方案。
这是 x402 吗?
本方案与具体协议无关。任何能够发起 HTTPS 调用并广播加密货币交易的技术栈都可以完成付款——无需 facilitator,也无需特殊的钱包 SDK。如果您的框架支持 x402 或 AP2,只需将开票调用封装进您的支付工具;该 JSON 契约可以清晰地映射为 402 风格的流程,原生 x402 协商也已列入路线图。
哪些支付链接和店铺支持智能体付款?
默认情况下,所有生效中的支付链接与店铺均支持——包括固定价格、自由金额、商品变体、买家字段、需配送的实物商品,以及带实时库存的完整店铺目录。卖方可在「设置」中按账户关闭智能体结账;关闭后相关接口将返回 403,而面向人类的页面仍照常运作。
智能体付款后会收到什么?
付款完成的瞬间,收据接口即以 JSON 形式返回交付内容:具体内容、私密链接,或为该笔付款预留的许可证密钥。实物订单则确认卖方已收到收货地址。
恶意智能体能否滥用这些接口?
智能体调用与托管结账页面共用完全相同的速率限制、开票上限与幂等规则——不会带来任何额外的攻击面。支付域名上不存在 cookie 或会话,因此跨站调用没有可利用的状态。