WooCommerce integration with Linkolino

• Backend Linkolino: POST /api/webhooks/woocommerce.
• Signature verification X-WC-Webhook-Signature.
• Support for statuses processing, completed, cancelled, failed, refunded.
• Plugin MVP w repo: integrations/woocommerce/linkolino-for-woocommerce.

1. 1. The affiliate sends the customer through a Linkolino link.
2. 2. Redirect Linkolino dopisuje do adresu sklepu ll_visitor_id.
3. 3. The WooCommerce plugin stores this identifier in a cookie, session and order meta.
4. 4. After the processing or completed status, the plugin sends a postback.
5. 5. Linkolino creates a conversion and calculates commission according to the program.

After installation, go to WooCommerce -> Settings -> Integration -> Linkolino and set:

• Endpoint - Linkolino application address.
• Program ID - affiliate program identifier.
• API key - merchant API key, used only server-side.
• Conversion statuses - statuses that create conversions.
• Order amount - whether to count the full amount or exclude shipping.

The plugin sends data from the WordPress backend, so the API key never reaches JavaScript.

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"
}

You can also configure a WooCommerce webhook without a plugin, but this variant requires the store to already save visitor_id in order metadata.