Flyer-codes automatisch verzilverd bij check-out.

Waarom dit de moeite is

Shopify (private app)

Voor Shopify-winkels gebruik je onze private app. Deze installeert een discount-code validator script op de check-out en schrijft een scriptTag dat bij elke checkout de flyer-code checkt via POST /api/codes/redeem.

// Shopify script tag (installeert zichzelf in checkout.liquid)
fetch('https://lokaalkabaal.agency/api/codes/redeem', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '${process.env.LOKAAL_KABAAL_REDEEM_KEY}',
  },
  body: JSON.stringify({
    code: discountCode,
    retailerId: '${window.LOKAAL_KABAAL_RETAILER_ID}',
    orderValue: orderTotal,  // optioneel, voor CLV
  }),
})
  .then(r => r.ok
    ? applyDiscount()
    : showInvalidCodeMessage()
  );

WooCommerce (PHP plugin)

De WooCommerce plugin hooks woocommerce_coupon_is_valid en doet dezelfde validatie. Installeer via WordPress admin, vul de retailer-ID en de redeem-key in, klaar.

<?php
add_filter('woocommerce_coupon_is_valid', function($valid, $coupon) {
  if (substr($coupon->get_code(), 0, 2) !== 'LK') return $valid;

  $resp = wp_remote_post('https://lokaalkabaal.agency/api/codes/redeem', [
    'headers' => [
      'X-API-Key' => get_option('lokaalkabaal_redeem_key'),
      'Content-Type' => 'application/json',
    ],
    'body' => wp_json_encode([
      'code' => $coupon->get_code(),
      'retailerId' => get_option('lokaalkabaal_retailer_id'),
    ]),
  ]);
  return wp_remote_retrieve_response_code($resp) === 200;
}, 10, 2);

Webhook-alternatief (any platform)

Werk je op Magento, Lightspeed of een custom stack? Gebruik onze webhook die bij elke conversion.registered event een payload naar jouw eigen endpoint pusht. Zie docs/webhooks voor payload-formaten en HMAC-verificatie.