Stripe Checkout

Jeśli tworzysz Sesje płatności Stripe na swoim serwerze, musisz przekazać click_id z przeglądarki do backendu i dołączyć go jako client_reference_id przy tworzeniu sesji. Selgeo odczytuje tę wartość z webhooka Stripe i przypisuje konwersję do partnera polecającego.

Wersja API: v1

Implementacja

Krok 1: Odczytaj ID kliknięcia we froncie

const clickId = __selgeo.getClickId();

Krok 2: Wyślij ID kliknięcia do backendu

const clickId = __selgeo.getClickId();

const response = await fetch('/api/create-checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ priceId: 'price_xxx', clickId: clickId }),
});

const { url } = await response.json();
window.location.href = url;

Krok 3: Przekaż jako client_reference_id

JavaScript (Node.js)

const stripe = require('stripe')('sk_test_YOUR_STRIPE_KEY');

app.post('/api/create-checkout', async (req, res) => {
  const { priceId, clickId } = req.body;
  const session = await stripe.checkout.sessions.create({
    mode: 'subscription',
    line_items: [{ price: priceId, quantity: 1 }],
    success_url: 'https://twoja-strona.com/success',
    cancel_url: 'https://twoja-strona.com/cancel',
    client_reference_id: clickId || undefined,
  });
  res.json({ url: session.url });
});

Python

import stripe

stripe.api_key = "sk_test_YOUR_STRIPE_KEY"

@app.route("/api/create-checkout", methods=["POST"])
def create_checkout():
    data = request.get_json()
    click_id = data.get("clickId")
    session = stripe.checkout.Session.create(
        mode="subscription",
        line_items=[{"price": data["priceId"], "quantity": 1}],
        success_url="https://twoja-strona.com/success",
        cancel_url="https://twoja-strona.com/cancel",
        client_reference_id=click_id if click_id else None,
    )
    return jsonify({"url": session.url})

PHP

$stripe = new \Stripe\StripeClient('sk_test_YOUR_STRIPE_KEY');
$data = json_decode(file_get_contents('php://input'), true);
$clickId = $data['clickId'] ?? null;
$session = $stripe->checkout->sessions->create([
    'mode' => 'subscription',
    'line_items' => [['price' => $data['priceId'], 'quantity' => 1]],
    'success_url' => 'https://twoja-strona.com/success',
    'cancel_url' => 'https://twoja-strona.com/cancel',
    'client_reference_id' => $clickId,
]);
echo json_encode(['url' => $session->url]);

Przekaż undefined, nie pusty ciąg

Jeśli nie ma click_id, przekaż undefined (JavaScript), None (Python) lub null (PHP). Nie przekazuj pustego ciągu.

Testowanie

1. Skonfiguruj partnera testowego i link śledzący. Zaproś partnera testowego w panelu sprzedawcy, następnie zaloguj się do portalu partnerskiego jako ten partner i utwórz link polecający (w sekcji Linki). Linki śledzące nie są tworzone w panelu sprzedawcy.
2. Odwiedź swoją stronę za pomocą linku śledzącego: https://twoja-strona.com/?ref=TWÓJ_REF
3. Zweryfikuj click ID w konsoli przeglądarki:

   __selgeo.getClickId() // Powinno zwrócić UUID

4. Uruchom swój proces płatności. click_id powinien zostać przekazany do Twojego backendu.
5. Sfinalizuj płatność przy użyciu karty testowej Stripe 4242 4242 4242 4242.
6. Sprawdź panel Selgeo — konwersja powinna pojawić się przypisana do partnera testowego.

Następne kroki

• Stripe Metadata — używanie metadanych sesji płatności zamiast client_reference_id
• API konwersji — dla konwersji nie-Stripe
• Tryb testowy — szczegółowy przewodnik testowania