Stripe Metadata

Jeśli tworzysz Sesje płatności Stripe przez API, możesz przekazać click_id w polu metadata Stripe używając klucza aff_click_id. Selgeo odczytuje te metadane z webhooków Stripe i przypisuje konwersję do partnera polecającego.

Wersja API: v1

Kiedy używać tego podejścia

Używaj metadanych Stripe gdy:

• Chcesz przekazać click_id razem ze swoją własną wartością client_reference_id.
• Tworzysz Sesje płatności, ale chcesz użyć client_reference_id do własnych celów.

Bezpośrednie Payment Intents i Subskrypcje nie są obsługiwane

Selgeo przetwarza metadane na zdarzeniach webhook checkout.session.completed i invoice.paid. Użyj zamiast tego API konwersji lub twórz subskrypcje przez Stripe Checkout.

Klucz metadanych

aff_click_id

Implementacja

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: 'moj_wewnetrzny_ref_123',
    metadata: {
      aff_click_id: clickId || '',
    },
  });
  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()
    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="moj_wewnetrzny_ref_123",
        metadata={"aff_click_id": data.get("clickId", "")},
    )
    return jsonify({"url": session.url})

PHP

$stripe = new \Stripe\StripeClient('sk_test_YOUR_STRIPE_KEY');
$data = json_decode(file_get_contents('php://input'), true);
$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' => 'moj_wewnetrzny_ref_123',
    'metadata' => ['aff_click_id' => $data['clickId'] ?? ''],
]);
echo json_encode(['url' => $session->url]);

Jak Selgeo przetwarza metadane

Dla zdarzeń checkout.session.completed Selgeo sprawdza click_id w następującej kolejności:

1. client_reference_id w Sesji płatności (jeśli obecny i jest prawidłowym UUID).
2. metadata.aff_click_id w Sesji płatności.

Następne kroki

• API konwersji — dla konwersji nie-Stripe
• Webhooki — otrzymywanie powiadomień gdy konwersje są przypisywane
• Tryb testowy — szczegółowy przewodnik testowania