接入

在你的网站上收加密货币

选一种方式。复制、粘贴，完成。

三种方式

1
创建商品
New product
Name
1,000 API credits
Price
24.00USD
1,000 API credits$24.00Active
2
复制链接
Link
```
https://pay.perly.io/l/your-link
```
pay.perly.io/l/your-link
Or print the QR.
Link copied

贴到任何地方

个人简介、消息、邮件、按钮、收银台二维码。

链接贴到哪里

Instagram, TikTok	编辑主页 → 链接 → 粘贴
Telegram, WhatsApp	粘贴到消息或频道帖子中
邮件	粘贴到正文中，或设为文字链接
Wix	按钮 → 链接 → 网址 → 粘贴
Tilda	按钮区块 → 内容 → 按钮链接 → 粘贴
Webflow	按钮 → 设置 → Link → URL → 粘贴
WordPress	“按钮”区块 → 链接 → 粘贴
Shopify	自定义主题 → 按钮 → 链接 → 粘贴
Notion	选中文字 → Link → 粘贴

在建站工具里：添加按钮，粘贴链接。

kestrel.test

AI models, paid by the credit.

pay.perly.io/l/your-link

Bio

Chat

How do I pay?pay.perly.io/l/your-link

Message

Your order

Pay here →

Buy now

Link

pay.perly.io/l/your-link

✓ Done

Site builder

4
买家付款
1,000 API credits
$24.00
BTC
USDC
USDT
USDC · Base
24.000000 USDC
Paid

1
允许你的网站
Settings → Checkout → Sites that may embed the checkout.
Checkout
Sites that may embed the checkout
https://yourshop.com
Saved

复制两行代码

data-paid-url — 买家付款后跳转的页面。可选。

HTML

<script src="https://pay.perly.io/pay/v1.23a909cfd386.js" integrity="sha384-I6kJz9OGuc1Fy9tFkKhteJN5O1VJx5cGMQBwpTucNp8u9kNSQ6v7bPnGqYcnFtb4" crossorigin="anonymous" defer></script>
<button data-perly-pay="your-link" data-paid-url="/thanks">Pay with crypto</button>

3
粘贴到 </body> 之前
任何页面，放在 </body> 正上方。
index.html Pasted
1<!doctype html>
2<html>
3<body>
4 <h1>Kestrel AI</h1>
5 <p>1,000 API credits — $24</p>
6 <script src="https://pay.perly.io/pay/v1.23a909cfd386.js" integrity="sha384-I6kJz9OGuc1Fy9tFkKhteJN5O1VJx5cGMQBwpTucNp8u9kNSQ6v7bPnGqYcnFtb4" crossorigin="anonymous" defer></script>
7 <button data-perly-pay="your-link" data-paid-url="/thanks">Pay with crypto</button>
8</body>
9</html>
← Paste here
4
点击：付款窗口在网站上方打开
你的页面也能收到：
perlypay:paid
```
<script>
  addEventListener("perlypay:paid", (e) => {
    console.log("Paid", e.detail.invoice); // inv_…
  });
</script>
```
Kestrel AI
1,000 API credits
$24.00
Pay with crypto
Thank you!
Your credits are ready.
pay.perly.io
Kestrel AI
$24.00
BTC
USDC
Paid
perlypay:paid { invoice: "inv_3f2a…" }

1
获取测试密钥
密钥只留在服务器上，绝不放进页面。
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_••••••••••••••••
2
安装 SDK
```
npm i perly-pay
```
~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready

创建账单并把买家引导过去

import { PerlyPay } from "perly-pay";

const pay = new PerlyPay(process.env.PERLY_PAY_SECRET_KEY); // sk_test_…

app.post("/buy", async (req, res) => {
  const invoice = await pay.invoices.create({
    line_items: [{ price: "price_…" }],
    return_url: "https://yourshop.com/thanks",
    metadata: { order: "1042" },
  });
  res.redirect(303, invoice.url); // https://pay.perly.io/i/<uuid>
});

通过 Webhook 得知付款

校验原始字节。在 invoice.fulfilled 时发货 — 它只来一次，且在核对之后。

app.post("/webhooks/perly", express.raw({ type: "application/json" }), (req, res) => {
  const event = pay.webhooks.verify(
    req.body,                         // the raw bytes, not parsed JSON
    req.header("Perly-Signature"),
    process.env.PERLY_PAY_WEBHOOK_SECRET,  // whsec_…
  ); // throws if forged, or older than 5 minutes

  if (event.type === "invoice.fulfilled") {
    ship(event.data.object.metadata.order); // once, after screening
  }
  res.sendStatus(204);
});

Webhooks

Endpoint URL

yourshop.com/webhooks/perly

https://yourshop.com/webhooks/perlyOn

whsec_•••• · shown once

invoice.paid200delivered

invoice.fulfilled200delivered

5
依次发生什么
先是 invoice.paid；invoice.fulfilled 表示可以发货了。
买家
你的网站
Perly Pay
网络
你的服务器
购买
POST /invoices
invoice.url
跳转到 /i/…
付款到你的地址
已发现，已确认
invoice.paid · invoice.fulfilled
收据
发货

先测试，再上线

1
测试模式
Kestrel AITest
Test networks. Nothing real moves.
2
Simulate payment
Test mode · No real money moves.
USDC · Base SepoliaPaid
24.000000
Short or over
3
Webhook 和收据
Webhooks
invoice.paid200delivered
invoice.fulfilled200delivered
receipt.created200delivered
Receipt
TEST-KS-2026-000124
1,000 API credits$24.00
PDF
4
上线：核对钱包
在钱包自己的屏幕上核对第一个地址。
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live

复制链接，贴到任何地方。

免费开始文档

三种方式

创建商品

复制链接

贴到任何地方

链接贴到哪里

买家付款

允许你的网站

复制两行代码

粘贴到 </body> 之前

点击：付款窗口在网站上方打开

获取测试密钥

安装 SDK

创建账单并把买家引导过去

通过 Webhook 得知付款

依次发生什么

先测试，再上线

测试模式

Simulate payment

Webhook 和收据

上线：核对钱包

复制链接，贴到任何地方。