Skip to main content

​
Fase 1: Backendconfiguratie (OAuth1 API)

Deze stap stelt Kleep in staat uw productcatalogus, ordergeschiedenis en retourgegevens op te halen om het algoritme te kalibreren.

​
1. OAuth1-integratie aanmaken

  1. Meld u aan bij uw Magento-beheerderspaneel.
  2. Ga naar System > Integrations.
  3. Klik op “Add New Integration”.
  4. Vul het veld Name in (bijv. “Kleep Integration”).
  5. Voer uw Admin Password in ter bevestiging.

​
2. API-machtigingen configureren

Dit moet overeenkomen met de volgende ACL’s in Magento:
  • Magento_Catalog::products
  • Magento_Catalog::categories
  • Magento_Sales::sales
  • Magento_Sales::creditmemo
  • Magento_Sales::actions_view
  • Magento_Rma::rma
  • Magento_Rma::magento_rma
  • Magento_Rma::rma_attributes
  • Vendor_Module::returns
  • Magento_CatalogInventory::cataloginventory
  • Magento_Store::store
  • Magento_Config::config
  • Magento_Inventory::inventory
  • Magento_Customer::customer
⚠️ Belangrijk:
  • Als uw Magento-instantie aanvullende API-lagen of aangepaste eindpunten blootstelt (bijvoorbeeld aangepaste retour/RMA API’s), neem dan contact met ons op.
  • Als u een externe retourprovider gebruikt zonder integratie via de Magento API, raadpleeg dan de documentatie over retourgegevens of neem contact met ons op om de juiste integratiemethode te kiezen.

​
3. Activeren en referenties ophalen

  1. Klik op “Save” om de integratie aan te maken.
  2. Klik op “Activate” bij de nieuw aangemaakte integratie.
  3. Een pop-up toont uw OAuth-referenties:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret
  4. Kopieer deze referenties – u moet ze doorsturen naar uw Kleep-contactpersoon.
Raadpleeg de volgende bronnen voor hulp bij het aanmaken en ophalen van Magento 2 API-referenties:
Subscribe Pro-handleiding: Magento 2 API-referenties aanmaken en ophalen Officiële Adobe-handleiding: Magento 2 OAuth-authenticatie

​
4. Firewallconfiguratie

If your store is behind a firewall or uses IP-based access restrictions, please whitelist the following Kleep IP addresses to ensure uninterrupted API access:
  • 34.1.4.3
  • 82.66.252.201
  • 176.148.67.162

​
5. Referenties naar Kleep sturen

Stuur de volgende informatie via e-mail naar uw Kleep-contactpersoon:
  1. Geef de volledige API-basis-URL(‘s) op voor de winkel(s).
  2. OAuth1-referenties
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret

​
Fase 2: Frontend-integratie (Widget)

Deze stap omvat het toevoegen van het Kleep-script aan uw productpagina’s (PDP). Compatibel met alle versies van Magento. Volg onze JS Library Widget-gids om de front-end CTA op uw productpagina’s te installeren en configureren.

​
Fase 3: Beheer van ontbrekende gegevens (SFTP)

Deze sectie is van toepassing wanneer gegevens niet kunnen worden opgehaald via standaard API-eindpunten. Als uw Magento API het ophalen van retouren of bepaalde specifieke gegevens niet toestaat, werken we via CSV-bestandsuitwisseling. Raadpleeg de onderstaande documentatie. Deze gids begeleidt u stap voor stap door het proces van het verzenden van ontbrekende gegevens:

​
Fase 4: Validatie & Productie-uitrol

​
1. Testomgeving

Implementeer eerst op uw Preprod/Staging-omgeving.

​
2. Visuele validatie

Controleer het volgende voordat u live gaat:
  • Wordt de knop correct weergegeven?
  • Opent een klik het pop-upvenster (Drawer)?
  • Geen “CORS”-fouten in de browserconsole?

​
3. Live gaan

Na validatie door u en het Kleep-team, implementeert u de wijzigingen in uw Productie-thema.---

​
Cookies & gegevensprivacy

Kleep is volledig afhankelijk van de toestemming van de bezoeker: het script wordt pas geladen nadat toestemming is verzameld via uw CMP, en u moet het laden hiervan dienovereenkomstig conditioneren. Zie Cookies, CMP & Gegevensprivacy voor de volledige lijst van trackers, de verwerkte gegevens, de doeleinden en rechtsgrondslagen, hosting, subverwerkers en beveiliging.