Intégration

Encaissez en crypto sur votre site

Choisissez une méthode. Copiez, collez, c’est fait.

Trois méthodes

1
Créez un produit
New product
Name
1,000 API credits
Price
24.00USD
1,000 API credits$24.00Active
2
Copiez son lien
Link
```
https://pay.perly.io/l/your-link
```
pay.perly.io/l/your-link
Or print the QR.
Link copied

Collez-le n’importe où

Bio, message, e-mail, bouton, QR sur un comptoir.

Où mettre le lien

Instagram, TikTok	Modifier le profil → Liens → coller
Telegram, WhatsApp	Collez dans un message ou un post de canal
E-mail	Collez dans le texte, ou sous un mot
Wix	Bouton → Lien → Adresse web → coller
Tilda	Bloc bouton → Contenu → Lien du bouton → coller
Webflow	Bouton → Paramètres → Link → URL → coller
WordPress	Bloc Boutons → Lien → coller
Shopify	Personnaliser le thème → Bouton → Lien → coller
Notion	Sélectionnez le texte → Link → coller

Sur un créateur de site : ajoutez un bouton, mettez-y le lien.

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
L’acheteur paie
1,000 API credits
$24.00
BTC
USDC
USDT
USDC · Base
24.000000 USDC
Paid

1
Autorisez votre site
Settings → Checkout → Sites that may embed the checkout.
Checkout
Sites that may embed the checkout
https://yourshop.com
Saved

Copiez deux lignes

data-paid-url : la page où arrive l’acheteur après paiement. Facultatif.

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
Collez avant </body>
N’importe quelle page. Juste au-dessus de </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
Cliquez : le paiement s’ouvre par-dessus votre site
Votre page l’entend aussi :
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
Prenez une clé de test
La clé secrète reste sur votre serveur. Jamais dans une page.
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_••••••••••••••••
2
Installez le SDK
```
npm i perly-pay
```
~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready

Créez une facture, envoyez-y l’acheteur

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

Soyez prévenu : un webhook

Vérifiez le corps brut. Expédiez sur invoice.fulfilled — il arrive une fois, après le contrôle.

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
Ce qui se passe, dans l’ordre
invoice.paid arrive d’abord ; invoice.fulfilled quand vous pouvez expédier sans risque.
Acheteur
Votre site
Perly Pay
Réseau
Votre serveur
Acheter
POST /invoices
invoice.url
Redirection vers /i/…
Paie à votre adresse
Vu, confirmé
invoice.paid · invoice.fulfilled
Reçu
Expédier

Testez, puis passez en réel

1
Mode test activé
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
Voyez le webhook et le reçu
Webhooks
invoice.paid200delivered
invoice.fulfilled200delivered
receipt.created200delivered
Receipt
TEST-KS-2026-000124
1,000 API credits$24.00
PDF
4
En réel : vérifiez votre portefeuille
Comparez la première adresse sur l’écran de votre portefeuille.
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live

Copiez un lien. Collez-le n’importe où.

Commencer gratuitement Lire la doc

Trois méthodes

Créez un produit

Copiez son lien

Collez-le n’importe où

Où mettre le lien

L’acheteur paie

Autorisez votre site

Copiez deux lignes

Collez avant </body>

Cliquez : le paiement s’ouvre par-dessus votre site

Prenez une clé de test

Installez le SDK

Créez une facture, envoyez-y l’acheteur

Soyez prévenu : un webhook

Ce qui se passe, dans l’ordre

Testez, puis passez en réel

Mode test activé

Simulate payment

Voyez le webhook et le reçu

En réel : vérifiez votre portefeuille

Copiez un lien. Collez-le n’importe où.