Integra
Incassa in crypto sul tuo sito
Scegli un modo. Copia, incolla, fatto.
Tre modi
- 1
Crea un prodotto
New product
Name
1,000 API creditsPrice
24.00USD1,000 API credits$24.00Active - 2
Copia il suo link
Linkpay.perly.io/l/your-linkOr print the QR.
Link copied - 3
Incollalo dove vuoi
Bio, messaggio, email, pulsante, QR alla cassa.
Dove va il link
Instagram, TikTok Modifica profilo → Link → incolla Telegram, WhatsApp Incollalo in un messaggio o in un post del canale Email Incollalo nel testo o sotto una parola Wix Pulsante → Link → Indirizzo web → incolla Tilda Blocco pulsante → Contenuto → Link del pulsante → incolla Webflow Pulsante → Impostazioni → Link → URL → incolla WordPress Blocco Pulsanti → Link → incolla Shopify Personalizza tema → Pulsante → Link → incolla Notion Seleziona il testo → Link → incolla In un site builder: aggiungi un pulsante e mettici il link.
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
L’acquirente paga
1,000 API credits
$24.00
BTCUSDCUSDTUSDC · Base24.000000 USDC
Paid
- 1
Prendi una chiave di test
La chiave segreta resta sul tuo server. Mai in una pagina.
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_•••••••••••••••• - 2
Installa l’SDK
npm i perly-pay~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready
- 3
Crea una fattura e manda lì l’acquirente
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
Scopri del pagamento: un webhook
Verifica il body grezzo. Spedisci l’ordine con invoice.fulfilled: arriva una volta, dopo la verifica.
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
Cosa succede, in ordine
Prima arriva invoice.paid; invoice.fulfilled quando puoi spedire.
AcquirenteIl tuo sitoPerly PayReteIl tuo serverAcquista
POST /invoices
invoice.url
Reindirizza a /i/…
Paga al tuo indirizzo
Visto, confermato
invoice.paid · invoice.fulfilled
Ricevuta
Spedisci
Provalo, poi vai live
- 1
Modalità test attiva
Kestrel AITestTest networks. Nothing real moves. - 2
Simulate payment
Test mode · No real money moves.
USDC · Base SepoliaPaid24.000000
Short or over
- 3
Guarda il webhook e la ricevuta
Webhooks
invoice.paid200deliveredinvoice.fulfilled200deliveredreceipt.created200deliveredReceipt
TEST-KS-2026-000124
1,000 API credits$24.00PDF - 4
In live: verifica il tuo wallet
Confronta il primo indirizzo sullo schermo del tuo wallet.
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live