PayPal Standaard installeren en instellen

Met de module PayPal Standaard kun je PayPal-betalingen accepteren in je webshop. In dit artikel leggen we stap voor stap uit hoe je een PayPal Developer App aanmaakt, een webhook instelt en de module correct configureert in je admin.

Tip: Doorloop deze handleiding eerst volledig in de Sandbox-omgeving voordat je live gaat. Zo weet je zeker dat alles werkt voordat er echt geld wordt overgemaakt.

Wat heb je nodig?

• Een PayPal-bedrijfsaccount
• Toegang tot developer.paypal.com
• Toegang tot de admin van je webshop
• Het domein van je webshop (voor de webhook-URL)

Stap 1 — PayPal Developer App aanmaken

Je hebt een PayPal Developer App nodig om een Client ID en Secret te genereren. Deze gebruikt de module om veilig met PayPal te communiceren.

1. Ga naar developer.paypal.com en log in met je PayPal-bedrijfsaccount.
2. Navigeer naar Apps & Credentials.
3. Zorg dat bovenaan Live is geselecteerd (kies Sandbox als je eerst wilt testen).
4. Klik op Create App.
5. Geef de app een herkenbare naam (bijvoorbeeld Webshop Live) en kies als app type Merchant.
6. Klik nogmaals op Create App.
7. Je ziet nu je Client ID en Secret. Kopieer beide en bewaar ze op een veilige plek.

Sandbox testen? Herhaal bovenstaande stappen in de Sandbox-omgeving. Je krijgt dan een aparte Client ID en Secret die je alleen voor testbetalingen gebruikt.

Stap 2 — Webhook aanmaken

De webhook zorgt ervoor dat PayPal automatisch je webshop informeert wanneer een betaling voltooid, afgewezen of terugbetaald wordt. Zonder webhook worden bestelstatussen niet bijgewerkt.

1. Open de zojuist aangemaakte app in het PayPal Developer Dashboard.
2. Scroll naar beneden naar Webhooks.
3. Klik op Add Webhook.
4. Vul bij Webhook URL het volgende in, waarbij je [jouw-domein] vervangt door je eigen domeinnaam:

https://[jouw-domein]/index.php?route=payment/pp_standard/webhook

5. Selecteer de volgende Event Types:
   • PAYMENT.CAPTURE.COMPLETED
   • PAYMENT.CAPTURE.PENDING
   • PAYMENT.CAPTURE.DENIED
   • PAYMENT.CAPTURE.REFUNDED
   • PAYMENT.CAPTURE.REVERSED
   • CHECKOUT.ORDER.DECLINED
   • PAYMENT.AUTHORIZATION.VOIDED
   • CHECKOUT.ORDER.EXPIRED
6. Klik op Save.
7. Kopieer het Webhook ID dat verschijnt (bijvoorbeeld 6XW78974WH999999W).

Let op: De webhook-URL moet openbaar bereikbaar zijn via HTTPS. Test-omgevingen achter een login of op localhost werken niet. Maak daarnaast een aparte webhook aan in de Sandbox-omgeving als je sandbox-betalingen gaat testen.

Stap 3 — Module configureren in de admin

Ga in je webshop naar:

admin/index.php?route=payment/pp_standard

Inloggegevens en instellingen

Veld	Waarde	Verplicht
Client ID (live)	Kopieer uit stap 1 (Live app)	Ja
Client Secret (live)	Kopieer uit stap 1 (Live app)	Ja
Client ID (sandbox)	Kopieer uit stap 1 (Sandbox app)	Nee
Client Secret (sandbox)	Kopieer uit stap 1 (Sandbox app)	Nee
Webhook ID	Het Webhook ID uit stap 2	Ja
Sandbox modus	Ja tijdens testen, Nee voor live	—
Debug modus	Ingeschakeld om het betalingsverloop te loggen in system/logs/	—
Totaal	Minimumbedrag waarbij deze betaalmethode getoond wordt (leeg = altijd zichtbaar)	—
Status	Zet op Ingeschakeld om de betaalmethode actief te maken	—

Bestelstatussen koppelen

Koppel elke PayPal-status aan een bestelstatus in je webshop. Onderstaande tabel bevat onze aanbevolen koppelingen:

PayPal status	Aanbevolen bestelstatus
Afgerond	Betaald / Verwerking
In afwachting	In afwachting
Afgewezen	Geannuleerd
Mislukt	Mislukt
Terugbetaald	Terugbetaald
Teruggeboekt	Geannuleerd
Verlopen	Verlopen
Ongeldig	Geannuleerd

Klik op Opslaan zodra alle velden zijn ingevuld.

Stap 4 — Testen voordat je live gaat

Voer altijd eerst een testbetaling uit voordat je PayPal live activeert. Zo voorkom je dat klanten tegen problemen aanlopen.

1. Zet Sandbox modus op Ja en controleer of de sandbox Client ID en Secret zijn ingevuld.
2. Zorg dat de sandbox-webhook is aangemaakt met de juiste URL.
3. Plaats een testbestelling met een PayPal sandbox-account.
4. Controleer of de bestelstatus correct wordt bijgewerkt nadat de betaling is voltooid.
5. Kijk in system/logs/ als er iets misgaat — met Debug modus aan vind je daar precies wat er gebeurt.
6. Zet Sandbox modus terug op Nee en sla de instellingen op om live te gaan.

Veelvoorkomende problemen

De bestelstatus wordt niet bijgewerkt na betaling

Controleer of het Webhook ID in de module exact overeenkomt met het ID in het PayPal Developer Dashboard, en of de webhook-URL bereikbaar is via HTTPS.

PayPal wordt niet getoond bij het afrekenen

Controleer of de module op Ingeschakeld staat en of het bestelbedrag boven het eventueel ingestelde minimumbedrag ligt.

Sandbox-betalingen lukken niet

Verifieer dat je een aparte webhook hebt aangemaakt binnen de Sandbox-omgeving en dat de sandbox Client ID/Secret zijn ingevuld.

Heb je na het doorlopen van deze stappen nog vragen of loopt er iets niet zoals verwacht? Neem gerust contact op met het support-team van theshopbuilders.