API & Developer Tools
Developer-first
desde o inicio.
SDK leve para embed do checkout na sua loja. PIX com QR Code em tempo real, Boleto e Cartao de Credito. Funciona com qualquer stack — HTML, React, Vue.
Checkout na sua loja em 3 passos
Backend cria a sessao, frontend monta o widget, webhook confirma o pagamento. Simples assim.
1
Backend — criar sessao
Node.js + HMAC auth
2
Frontend — montar widget
Script CDN ou npm install
3
Webhook — confirmar pedido
Assinatura HMAC v1 verificada
quick-start.ts
// ── Passo 1: Backend (Node.js) ──────────────────────────────────────
import crypto from 'node:crypto';
function harpyioAuth(pubKey, secKey, method, path, body = '') {
const ts = new Date().toISOString();
const nonce = crypto.randomUUID();
const msg = `${ts}.${nonce}.${method}.${path}.${body}`;
const sig = crypto.createHmac('sha256', secKey).update(msg).digest('hex');
return `HMAC ApiKey=${pubKey};Timestamp=${ts};Nonce=${nonce};Signature=${sig}`;
}
const body = JSON.stringify({ amount: 9990, currency: 'BRL',
paymentMethods: ['PIX', 'CREDIT_CARD'] });
const { sessionId, clientSecret } = await fetch(
'https://api.harpyio.com/checkout/sessions',
{ method: 'POST', body,
headers: { 'Content-Type': 'application/json',
'Authorization': harpyioAuth(API_KEY, API_SECRET, 'POST',
'/checkout/sessions', body) } }
).then(r => r.json());
// ── Passo 2: Frontend ────────────────────────────────────────────────
// <script src="https://cdn.harpyio.com/checkout/latest/harpyio-checkout.min.js">
const instance = Harpyio.checkout({ apiUrl: 'https://api.harpyio.com',
sessionId, clientSecret, locale: 'pt-BR' });
instance.mount('#checkout');
instance.on('payment.success', (d) => location.href = '/obrigado?txn=' + d.transactionId);Recursos para desenvolvedores
Pronto para integrar?
Crie sua conta, gere sua API Key e coloque o checkout no ar hoje. Sem cartao de credito.