Integracja WooCommerce z Linkolino

• Backend Linkolino: POST /api/webhooks/woocommerce.
• Weryfikacja podpisu X-WC-Webhook-Signature.
• Obsługa statusów processing, completed, cancelled, failed, refunded.
• Plugin MVP w repo: integrations/woocommerce/linkolino-for-woocommerce.

1. 1. Afiliant wysyła klienta przez link Linkolino.
2. 2. Redirect Linkolino dopisuje do adresu sklepu ll_visitor_id.
3. 3. Wtyczka WooCommerce zapisuje ten identyfikator w cookie, sesji i order meta.
4. 4. Po statusie processing albo completed wtyczka wysyła postback.
5. 5. Linkolino tworzy konwersję i nalicza prowizję według programu.

Po instalacji przejdź do WooCommerce -> Settings -> Integration -> Linkolino i ustaw:

• Endpoint - adres aplikacji Linkolino.
• Program ID - identyfikator programu afiliacyjnego.
• API key - klucz API merchanta, używany tylko po stronie serwera.
• Conversion statuses - statusy, które naliczają konwersję.
• Order amount - czy liczyć od całej kwoty, czy bez kosztu dostawy.

Wtyczka wysyła dane z backendu WordPress, więc klucz API nie trafia do JavaScriptu.

POST https://app.linkolino.pl/api/postback/PROGRAM_ID
X-Api-Key: TWOJ_KLUCZ_API
Content-Type: application/json

{
  "order_id": "wc-12345",
  "amount": "249.90",
  "currency": "PLN",
  "visitor_id": "VISITOR_ID",
  "customer_id": "42",
  "source": "woocommerce"
}

Możesz też skonfigurować webhook WooCommerce bez wtyczki, ale ten wariant wymaga, aby sklep już zapisywał visitor_id w metadanych zamówienia.