> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/extensions/extensions-nl/plugins/shopware-webhook-plugin.md).

# Shopware Webhook-plugin

Installeer en valideer AdPage-aankoopwebhooks voor je Shopware-winkel.

Gebruik de AdPage Shopware-plugin om aankoopgegevens vanuit de backend van je winkel door te sturen.

<a href="https://github.com/AdPageGroup/Shopware" class="button primary" data-icon="github">Bekijk de Shopware-plugin</a>

### Voordat je begint

Zorg ervoor dat je toegang hebt tot je Shopware-server, de configuratie van het verkoopkanaal en de container van de AdPage-server. Verwijder dubbele aankoop-webhooks voordat je de plugin test.

Maak een back-up van je winkel en test de installatie eerst in een staging-omgeving.

### Installeer de plug-in

{% stepper %}
{% step %}

#### Installeer de AdPage Webhook-plugin

Open de pluginrepository en installeer de plugin via Composer. Volg de installatie-instructies van de repository voor jouw Shopware-versie.
{% endstep %}

{% step %}

#### Configureer elk verkoopkanaal

Open de plugininstellingen van AdPage in Shopware. Selecteer elk verkoopkanaal waarvan je de bestellingen wilt doorsturen.

Voer de tagging-URL in voor elk geselecteerd kanaal. Deze moet overeenkomen met de tagging-URL die is geconfigureerd in je AdPage-servercontainer.
{% endstep %}

{% step %}

#### Publiceer je wijzigingen

Sla de pluginconfiguratie op en wis de Shopware-caches. Publiceer je Google Tag Manager-servercontainer nadat je de integratie in previewmodus hebt gevalideerd.
{% endstep %}
{% endstepper %}

### Valideer de installatie

Plaats een testbestelling via elk geconfigureerd verkoopkanaal. Bevestig vervolgens dat de aankoop-webhook je AdPage-servercontainer bereikt.

Controleer of de bestelling de verwachte transactie-ID, waarde, valuta en items bevat. Gebruik de preview van de Google Tag Manager-server om te verifiëren dat je downstream-tags één keer afgaan.

### Beschikbaar Shopware-webhookevent

De plugin verstuurt de voltooide bestelling als een aankoop-webhook. Deze wordt verzonden vanuit de Shopware-backend.

Dit beschermt het volgen van aankopen wanneer scripts aan de browserzijde niet worden uitgevoerd. Gebruik het samen met je ecommerce-datalayer van de storefront voor volledige tracking.

Zie [Shopware](/documentation/documentation-nl/website-integraties/shopware.md) voor datalayer- en GTM-instelling.

{% hint style="warning" %}
Test aankopen niet met een live betaalmethode. Gebruik een testbetaalmethode of een stagingwinkel.
{% endhint %}

### Problemen oplossen

Als de webhook niet aankomt, controleer dan of de plugin actief is. Controleer de tagging-URL voor het betreffende verkoopkanaal en wis de Shopware-caches.

Als aankopen dubbel worden geregistreerd, schakel dan overlappende Shopware-webhooks of webhooks van derden voor bestellingen uit. Test opnieuw met één testbestelling per verkoopkanaal.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.adpage.io/extensions/extensions-nl/plugins/shopware-webhook-plugin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.