導入

自分のサイトで暗号資産を受け取る

方法を選ぶ。コピーして、貼るだけ。

3 つの方法

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

どこにでも貼る

プロフィール、メッセージ、メール、ボタン、店頭の QR。

リンクを貼る場所

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

2 行をコピー

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 で — 確認後に 1 回だけ届きます。

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

リンクをコピー。どこにでも貼れます。

無料で始めるドキュメント

3 つの方法

商品を作成

リンクをコピー

どこにでも貼る

リンクを貼る場所

購入者が支払う

自分のサイトを許可

2 行をコピー

</body> の前に貼る

クリックすると、サイトの上に支払い画面が開く

テストキーを取得

SDK をインストール

請求書を作成し、購入者をそこへ送る

支払いを知る：Webhook

流れを順番に

まずテスト、それから本番

テストモード

Simulate payment

Webhook と領収書

本番：ウォレットを確認

リンクをコピー。どこにでも貼れます。