Magento

​

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. 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.