Integracja

Wybierz swoją ścieżkę — integracja w kilka minut.

Jedna z tych czterech opcji opisuje ciebie. Kliknij ją, a przeprowadzimy cię przez dokładne kroki dla twojego stacka — nic więcej, nic mniej.

No site at all?
Wix, Squarespace, Webflow, Framer, plain HTML?
Dla devów, którzy chcą pełnej kontroli

API + SDK — integracja w stylu Stripe

Trzy endpointy, jeden webhook. Tyle. Użyj SDK dla Node albo waląc raw API z dowolnego języka.

npm install github:kinerette/Qist-sdkNode · w stylu Stripe

SDK to cienki wrapper nad trzema endpointami. Jak wolisz raw fetch, olej SDK — każdy przykład poniżej działa bez niego.

POST/api/v1/checkout/initWygeneruj URL hosted checkoutu
GET/api/v1/sessions/{id}Pooluj status sesji (fallback dla webhooka)
POST{your-site}/api/peptidepay-webhookPeptidePay → ty. Podpisany HMAC. Oznacz zamówienie jako opłacone.
+Stwórz sesję checkoutuPokaż kod
// Create a checkout session and redirect the customer.
const res = await fetch('https://pay.qistdigital.com/api/v1/checkout/init', {
  method: 'POST',
  headers: {
    'Content-Type':  'application/json',
    Authorization:   `Bearer ${process.env.PEPTIDEPAY_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    amount_cents: 5000,              // 50.00 EUR
    currency:     'EUR',
    metadata:     { order_id: 'ord_123' },
    success_url:  'https://mysite.com/order/ord_123',
    cancel_url:   'https://mysite.com/cart',
  }),
});
const { url } = await res.json();
return Response.redirect(url, 303);
+Zweryfikuj webhook (HMAC timing-safe)Pokaż kod

Header x-peptidepay-signature to t=<unix_seconds>,v1=<hex HMAC-SHA256>. Oblicz HMAC-SHA256(whsec_secret, t + "." + raw_body) i timing-safe-porównaj z v1. Odrzuć cokolwiek starszego niż 5 minut. Parsuj JSON tylko po weryfikacji. Wymaga konta signup dla sekretu whsec_ — flow wallet-only dostarczają bez podpisu.

import crypto from 'node:crypto';

export async function POST(req: Request) {
  const raw = await req.text();                                     // MUST be raw bytes
  const sigHeader = req.headers.get('x-peptidepay-signature') ?? '';
  // Header format: t=<unix_seconds>,v1=<hex HMAC-SHA256>
  const [tPart, v1Part] = sigHeader.split(',');
  const t  = tPart?.split('=')[1];
  const v1 = v1Part?.split('=')[1];
  if (!t || !v1) return new Response('bad sig', { status: 400 });

  // Reject replays > 5 min old.
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) {
    return new Response('stale', { status: 400 });
  }

  const expected = crypto
    .createHmac('sha256', process.env.PEPTIDEPAY_WEBHOOK_SECRET!)
    .update(`${t}.${raw}`)                                        // ts + '.' + body
    .digest('hex');

  if (v1.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(v1, 'hex'), Buffer.from(expected, 'hex'))) {
    return new Response('invalid sig', { status: 401 });
  }

  const event = JSON.parse(raw);                                    // parse only after verify
  if (event.event === 'order.paid') {
    await markOrderPaid(event.order_id, event.txid);                // idempotent on session_id
  }
  return new Response('ok', { status: 200 });
}
+Pełny flow — Next.js App RouterPokaż kod
// app/api/checkout/route.ts
export async function POST(req: Request) {
  const { product_slug, quantity } = await req.json();
  const product = await db.product.findUnique({ where: { slug: product_slug } });
  if (!product) return new Response('not found', { status: 404 });

  const order = await db.order.create({
    data: { product_id: product.id, quantity, status: 'pending' },
  });

  const r = await fetch('https://pay.qistdigital.com/api/v1/checkout/init', {
    method: 'POST',
    headers: {
      'Content-Type':    'application/json',
      Authorization:     `Bearer ${process.env.PEPTIDEPAY_API_KEY}`,
      'Idempotency-Key': order.id,
    },
    body: JSON.stringify({
      amount_cents: product.price_cents * quantity,
      currency:     'EUR',
      metadata:     { order_id: order.id },
      success_url:  `${process.env.PUBLIC_URL}/order/${order.id}`,
      cancel_url:   `${process.env.PUBLIC_URL}/cart`,
    }),
  });

  const { url } = await r.json();
  return Response.json({ url });
}

// app/api/peptidepay-webhook/route.ts — verify HMAC, mark order paid.
// app/order/[id]/page.tsx            — success page polls /api/order/[id]
// app/api/order/[id]/route.ts        — returns order.status for the poller.

5 pytań, które każdy zadaje

Czy muszę rejestrować firmę?+
Nie. Tryb wallet-only potrzebuje tylko adresu USDC na Polygonie. Środki trafiają bezpośrednio na twój wallet — my ich nigdy nie trzymamy.
Jak mój klient płaci — karta czy krypto?+
Oba. Nasz hosted checkout przyjmuje Apple Pay, Google Pay, Visa/Mastercard/Amex i krypto bezpośrednio. Zawsze dostajesz USDC na Polygonie.
Jaka jest opłata?+
Flat 3%. Bez miesięcznej, bez setupu, bez chargeback bullshitu. Co klient zapłaci minus 3% ląduje na twoim wallecie.
Mogę testować bez wydawania prawdziwej kasy?+
Użyj karty dev MoonPay 4242 4242 4242 4242 z dowolną przyszłą datą ważności. Podepnij webhook pod tunel ngrok, żeby zobaczyć podpisany POST end-to-end.
Coś nie działa. Z kim pogadać?+
Telegram @vidaspi. Wyślij screena błędu, session id i co próbowałeś. Prawdziwi ludzie, zwykle pod godzinę w dni robocze.