Integration
Krypto auf Ihrer Website annehmen
Weg wählen. Kopieren, einfügen, fertig.
Drei Wege
- 1
Produkt anlegen
New product
Name
1,000 API creditsPrice
24.00USD1,000 API credits$24.00Active - 2
Link kopieren
Linkpay.perly.io/l/your-linkOr print the QR.
Link copied - 3
Überall einfügen
Bio, Nachricht, E-Mail, Button, QR an der Kasse.
Wohin der Link kommt
Instagram, TikTok Profil bearbeiten → Links → einfügen Telegram, WhatsApp In eine Nachricht oder einen Kanalpost einfügen E-Mail In den Text einfügen oder unter ein Wort legen Wix Button → Link → Webadresse → einfügen Tilda Button-Block → Inhalt → Button-Link → einfügen Webflow Button → Settings → Link → URL → einfügen WordPress Block „Buttons“ → Link → einfügen Shopify Theme anpassen → Button → Link → einfügen Notion Text markieren → Link → einfügen Im Website-Baukasten: Button hinzufügen, Link setzen.
kestrel.testAI models, paid by the credit.
pay.perly.io/l/your-link
Bio ChatHow do I pay?pay.perly.io/l/your-linkMessage Your orderPay here →Email Buy nowLink
pay.perly.io/l/your-link✓ Done
Site builder - 4
Der Käufer zahlt
1,000 API credits
$24.00
BTCUSDCUSDTUSDC · Base24.000000 USDC
Paid
- 1
Testschlüssel holen
Der geheime Schlüssel bleibt auf Ihrem Server. Nie in einer Seite.
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_•••••••••••••••• - 2
SDK installieren
npm i perly-pay~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready
- 3
Rechnung erstellen, Käufer dorthin schicken
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> }); - 4
Davon erfahren: ein Webhook
Prüfen Sie den rohen Body. Versenden Sie bei invoice.fulfilled – es kommt einmal, nach der Prüfung.
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/perlyhttps://yourshop.com/webhooks/perlyOnwhsec_•••• · shown once
invoice.paid200deliveredinvoice.fulfilled200delivered - 5
Was passiert, der Reihe nach
Zuerst kommt invoice.paid; invoice.fulfilled, wenn der Versand sicher ist.
KäuferIhre WebsitePerly PayBlockchainIhr ServerKaufen
POST /invoices
invoice.url
Weiter zu /i/…
Zahlt an Ihre Adresse
Gesehen, bestätigt
invoice.paid · invoice.fulfilled
Beleg
Versenden
Erst testen, dann live
- 1
Testmodus an
Kestrel AITestTest networks. Nothing real moves. - 2
Simulate payment
Test mode · No real money moves.
USDC · Base SepoliaPaid24.000000
Short or over
- 3
Webhook und Beleg ansehen
Webhooks
invoice.paid200deliveredinvoice.fulfilled200deliveredreceipt.created200deliveredReceipt
TEST-KS-2026-000124
1,000 API credits$24.00PDF - 4
Live gehen: Wallet prüfen
Vergleichen Sie die erste Adresse auf dem Display Ihrer Wallet.
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live