Integrar
Receba em cripto no seu site
Escolha uma forma. Copie, cole e pronto.
Três formas
- 1
Crie um produto
New product
Name
1,000 API creditsPrice
24.00USD1,000 API credits$24.00Active - 2
Copie o link dele
Linkpay.perly.io/l/your-linkOr print the QR.
Link copied - 3
Cole onde quiser
Bio, mensagem, e-mail, botão, QR no balcão.
Onde vai o link
Instagram, TikTok Editar perfil → Links → colar Telegram, WhatsApp Cole numa mensagem ou num post do canal E-mail Cole no texto ou sob uma palavra Wix Botão → Link → Endereço web → colar Tilda Bloco de botão → Conteúdo → Link do botão → colar Webflow Botão → Configurações → Link → URL → colar WordPress Bloco Botões → Link → colar Shopify Personalizar tema → Botão → Link → colar Notion Selecione o texto → Link → colar Num criador de sites: adicione um botão e coloque o link nele.
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
O comprador paga
1,000 API credits
$24.00
BTCUSDCUSDTUSDC · Base24.000000 USDC
Paid
- 1
Pegue uma chave de teste
A chave secreta fica no seu servidor. Nunca numa página.
API keys
Local dev
sk_test_…
Copy it now. It is shown once.
sk_test_•••••••••••••••• - 2
Instale o SDK
npm i perly-pay~/shop $ npm i perly-pay
added 1 package in 1s
0 dependencies · TypeScript types included
ready
- 3
Crie uma fatura e mande o comprador para ela
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
Saiba do pagamento: um webhook
Verifique o corpo bruto. Entregue o pedido com invoice.fulfilled: chega uma vez, depois da verificação.
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
O que acontece, em ordem
Primeiro chega invoice.paid; invoice.fulfilled, quando você já pode entregar.
CompradorSeu sitePerly PayRedeSeu servidorComprar
POST /invoices
invoice.url
Redireciona para /i/…
Paga no seu endereço
Visto, confirmado
invoice.paid · invoice.fulfilled
Recibo
Entregar
Teste e depois vá para produção
- 1
Modo de teste ativo
Kestrel AITestTest networks. Nothing real moves. - 2
Simulate payment
Test mode · No real money moves.
USDC · Base SepoliaPaid24.000000
Short or over
- 3
Veja o webhook e o recibo
Webhooks
invoice.paid200deliveredinvoice.fulfilled200deliveredreceipt.created200deliveredReceipt
TEST-KS-2026-000124
1,000 API credits$24.00PDF - 4
Em produção: confira sua carteira
Compare o primeiro endereço na tela da sua própria carteira.
Wallets · live · first address
bc1q9h7…x7f2
Verify address
bc1q9h7…x7f2
Live