// integracje

Cztery ścieżki. Od zera kodu po pełne SDK.

Wybierz jak głęboko chcesz wejść — kierowanie domeny przez gateway, wtyczka WordPress, middleware w Twoim backendzie albo płatności dla agentów AI.

Jestem wydawcą — chcę zarabiać na treści

Blog, serwis informacyjny, dokumentacja, API. Wybierz ścieżkę A–C: od zera zmian w kodzie po SDK.

Prowadzę agenta AI — chcę pobierać treść

Twój agent dostaje 402? Skonfiguruj płatności automatyczne z limitami wydatków (ścieżka D — serwer MCP lub SDK).

Domena przez gateway

bez programowania

Kierujesz domenę (CNAME/proxy) na gateway CrawlPay. Gateway egzekwuje płatności na brzegu: boty dostają challenge 402, opłacone żądania są proxowane do Twojego serwera. Na stronie osadzasz tylko widget — serwowany z Twojej domeny (same-origin), cookie jest first-party HttpOnly.

<script src="/widget/ppc-widget.js" defer
        data-lang="pl"
        data-target="#ppc-pay"></script>
<div id="ppc-pay"></div>

Wtyczka WordPress

WordPress

Zainstaluj wtyczkę, w konsoli utwórz aplikację, cennik i trasę, wklej Gateway URL i klucze API, włącz egzekwowanie. Ludzie zobaczą paywall z przyciskiem „Zapłać”; po płatności wtyczka wpuści ich automatycznie (cookie ppc_pass).

# Weryfikacja — powinno zwrócić 402 z challenge x402:
curl -i -A "GPTBot/1.0" https://twoja-strona.pl/

Pobierz wtyczkę (.zip)

JS SDK (Node / Express)

dla developerów

Dla własnych backendów bez zmian DNS. Middleware pyta gateway o decyzję dla każdego żądania i ją odzwierciedla (200 / 402 / 403 / 429). Przepustki kupione widgetem są honorowane automatycznie (cookie ppc_pass / nagłówek X-PPC-Pass).

const express = require("express");
const { paypercrawl } = require("@paypercrawl/sdk");

const app = express();
app.use(paypercrawl({
  gatewayUrl: "https://gateway.crawlpay.io",
  publishableKey: process.env.PPC_PK,
  secretKey: process.env.PPC_SK,
}));

app.get("/artykuly/:id", handler); // 402/403/429 obsłużone przez middleware

Na stronach HTML osadź widget w trybie embed (bez CNAME) — wskaż gateway i klucz publiczny aplikacji:

<script src="https://gateway.crawlpay.io/widget/ppc-widget.js" defer
        data-gateway="https://gateway.crawlpay.io"
        data-app-key="ppc_pk_..."
        data-lang="pl"
        data-target="#ppc-pay"></script>
<div id="ppc-pay"></div>

Pobierz SDK (.tgz)

Dla agentów AI — jak płacić

dla agentów AI

Agent, który dostał 402, podpisuje autoryzację EIP-3009 i ponawia żądanie z nagłówkiem X-PAYMENT. Najprościej: serwer MCP paypercrawl-agent-pay płaci automatycznie w ramach limitów. Programistycznie payFetch obsługuje pełny przepływ.

const { payFetch } = require("@paypercrawl/sdk");

const res = await payFetch("https://wydawca.pl/api/dane", {}, {
  signer: async (req) => signWithMyWallet(req),
});

Pobierz serwer MCP (.tgz)Instrukcja konfiguracji MCP (3 kroki) — na stronie Demo →

Checklist startowy (konsola)

Utwórz aplikację (domena + adres originu).

Dodaj cennik i trasę — wybierz, kto płaci (agenci AI, boty, wszyscy…).

Dla ruchu ludzkiego: Monetization → Access Pass — zaznacz oferowane plany przepustek.

Integracja WordPress/SDK: zakładka Developer → wygeneruj klucze API.

Przetestuj: curl -A "GPTBot/1.0" powinno zwrócić 402; wejście z przeglądarki pokaże paywall.

Otwórz konsolę