Integracja

Przyjmuj krypto na swojej stronie

Wybierz sposób. Skopiuj, wklej, gotowe.

Trzy sposoby

1
Utwórz produkt
New product
Name
1,000 API credits
Price
24.00USD
1,000 API credits$24.00Active
2
Skopiuj link
Link
```
https://pay.perly.io/l/your-link
```
pay.perly.io/l/your-link
Or print the QR.
Link copied

Wklej gdziekolwiek

Bio, wiadomość, e-mail, przycisk, QR przy kasie.

Gdzie wkleić link

Instagram, TikTok	Edytuj profil → Linki → wklej
Telegram, WhatsApp	Wklej w wiadomość lub post na kanale
E-mail	Wklej w treść albo pod słowo
Wix	Przycisk → Link → Adres internetowy → wklej
Tilda	Blok przycisku → Treść → Link przycisku → wklej
Webflow	Przycisk → Ustawienia → Link → URL → wklej
WordPress	Blok „Przyciski” → Link → wklej
Shopify	Dostosuj motyw → Przycisk → Link → wklej
Notion	Zaznacz tekst → Link → wklej

W kreatorze stron: dodaj przycisk, wklej 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
Kupujący płaci
1,000 API credits
$24.00
BTC
USDC
USDT
USDC · Base
24.000000 USDC
Paid

1
Dopuść swoją stronę
Settings → Checkout → Sites that may embed the checkout.
Checkout
Sites that may embed the checkout
https://yourshop.com
Saved

Skopiuj dwie linijki

data-paid-url — dokąd kupujący trafi po zapłacie. Opcjonalnie.

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
Wklej przed </body>
Dowolna strona. Tuż nad </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
Kliknij: płatność otwiera się nad stroną
Twoja strona też to słyszy:
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
Weź klucz testowy
Klucz tajny zostaje na serwerze. Nigdy na stronie.
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_••••••••••••••••
2
Zainstaluj SDK
```
npm i perly-pay
```
~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready

Utwórz fakturę i wyślij na nią kupującego

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

Dowiedz się o płatności: webhook

Weryfikuj surowe bajty. Wydawaj towar na invoice.fulfilled — przychodzi raz, po sprawdzeniu.

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
Co się dzieje, po kolei
Najpierw invoice.paid; invoice.fulfilled — gdy można wydać towar.
Kupujący
Twoja strona
Perly Pay
Sieć
Twój serwer
Kup
POST /invoices
invoice.url
Przejście na /i/…
Płaci na Twój adres
Widoczna, potwierdzona
invoice.paid · invoice.fulfilled
Paragon
Wydaj towar

Przetestuj, potem na żywo

1
Tryb testowy
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 i paragon
Webhooks
invoice.paid200delivered
invoice.fulfilled200delivered
receipt.created200delivered
Receipt
TEST-KS-2026-000124
1,000 API credits$24.00
PDF
4
Na żywo: sprawdź portfel
Porównaj pierwszy adres na ekranie samego portfela.
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live

Skopiuj link. Wklej gdziekolwiek.

Zacznij za darmo Dokumentacja

Trzy sposoby

Utwórz produkt

Skopiuj link

Wklej gdziekolwiek

Gdzie wkleić link

Kupujący płaci

Dopuść swoją stronę

Skopiuj dwie linijki

Wklej przed </body>

Kliknij: płatność otwiera się nad stroną

Weź klucz testowy

Zainstaluj SDK

Utwórz fakturę i wyślij na nią kupującego

Dowiedz się o płatności: webhook

Co się dzieje, po kolei

Przetestuj, potem na żywo

Tryb testowy

Simulate payment

Webhook i paragon

Na żywo: sprawdź portfel

Skopiuj link. Wklej gdziekolwiek.