연동

내 사이트에서 암호화폐 받기

방법을 고르세요. 복사, 붙여 넣기, 끝.

세 가지 방법

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

두 줄 복사

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>
});

결제 소식 받기: 웹훅

원본 바이트로 검증하세요. 배송은 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
웹훅과 영수증
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 설치

청구서를 만들고 구매자를 보내기

결제 소식 받기: 웹훅

일어나는 일, 순서대로

테스트한 뒤 라이브로

테스트 모드

Simulate payment

웹훅과 영수증

라이브: 지갑 확인

링크를 복사해 어디든 붙여 넣으세요.