PayPal

Wat u nodig hebt

Waarom we om elk veld vragen

Client ID

Identificeert uw PayPal-app bij API-aanroepen. Het werkt alleen wanneer het is gekoppeld aan het Client secret.

Client secret

De private helft van de API-auth. Samen met de Client ID laat het ons de order aanmaken, zodat de betaling via uw account loopt.

Webhook ID

Hoe we bevestigen dat een webhook echt van PayPal is: PayPal identificeert elke webhook met een ID, en we gebruiken het om PayPal rechtstreeks te vragen of een bepaald bericht authentiek is. Dat belet iedereen om een "betaald"-event te vervalsen.

Success- en Cancel-URL

Gewone instellingen: waar de koper belandt na het betalen of afhaken. Niet geheim.

Instellen

1. Open het PayPal Developer-dashboard

   Log in op developer.paypal.com. PayPal geeft u gratis een Sandbox met nep zakelijke en koperaccounts, zodat u kunt testen zonder echt geld te verplaatsen. Deze gids loopt de Sandbox door; de Live-stroom is identiek, wissel gewoon de schakelaar Sandbox / Live (linksboven) om en gebruik een PayPal for Business-account. Open vanuit het dashboard Apps & Credentials.

   ⤢
2. Maak een app aan

   Bevestig op de pagina API Credentials dat de schakelaar Sandbox is geselecteerd, klik dan op Create App (rechtsboven).

   ⤢
3. Geef hem een naam en kies Merchant

   Voer een App Name in (bijvoorbeeld "Coin Moebius"), laat het Type op Merchant staan, kies uw sandbox-zakelijk account, en klik op Create App.

   ⤢
4. Kopieer uw Client ID en Client secret

   PayPal opent uw nieuwe app. Kopieer de Client ID en onthul en kopieer de Secret key. (U kunt beide ook kopiëren uit de rij Default Application op de lijst API Credentials.) Zet ze opzij.

   ⤢

   ⤢

   Het Client secret is geheim, behandel het als een wachtwoord. De sandbox-app en live-app hebben elk hun eigen paar, haal ze niet door elkaar.

5. Voeg een webhook toe

   Scroll op de app-pagina naar beneden naar de sectie Sandbox Webhooks en klik op Add Webhook. Plak in het veld Webhook URL uw PayPal-webhookadres van het project (hieronder). Kies dan de events waarop Coin Moebius luistert, en sla op.

   • Eenmalige betalingen: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Abonnementen (alleen als u die verkoopt): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Als u niet op terugkerende basis factureert, sla deze dan over.
   • Haast? All Events selecteren (de jokerteken bovenaan) werkt ook, we negeren alles wat we niet gebruiken.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢

   Uw project-id staat onder de projectnaam in het Coin Moebius-dashboard; voeg het in het bovenstaande adres in. De verbonden providerkaart (laatste stap) toont dezelfde URL ter referentie.

6. Kopieer de Webhook ID

   Uw webhook verschijnt nu in de lijst Sandbox Webhooks. Kopieer de Webhook ID die ernaast wordt getoond. Zo vraagt Coin Moebius PayPal om te bevestigen dat elke webhook authentiek is. Registreer een aparte webhook in sandbox en in live.

   ⤢
7. Terug in Coin Moebius: Provider toevoegen → PayPal

   Open in uw project het tabblad Providers, klik op Provider toevoegen, kies Een dienst verbinden, en kies PayPal. Stel uw Success-URL en Cancel-URL in. Testen met sandbox-inloggegevens? Gebruik het tabblad Test (optioneel) en plak uw Client ID, Client secret en Webhook ID daar, klik dan op Opslaan. Direct live? Gebruik het tabblad Live. De Test-groep is alles-of-niets: alle drie de velden, of geen.

   ⤢
8. U bent verbonden

   PayPal verschijnt nu op uw tabblad Providers met de datum waarop het verbonden werd (gemarkeerd als TEST wanneer u sandbox-inloggegevens gebruikte). De kaart toont dezelfde webhook-URL die u in PayPal heeft geplakt, plus Bewerken en Verbreken.

   ⤢
9. Testen met een sandbox-koper

   Om via een test-checkout te betalen, heeft u uw sandbox-koperlogin nodig. Open in PayPal Testing Tools → Sandbox Accounts om uw nep zakelijke en persoonlijke accounts te bekijken.

   ⤢
10. Haal de koperlogingegevens op

    Open het persoonlijke (koper-)account om zijn Login Info te bekijken: de sandbox-URL, het e-mailadres en het wachtwoord. Log in op sandbox.paypal.com met die gegevens wanneer een test-checkout u vraagt te betalen. Er verplaatst geen echt geld.

    ⤢

Nadat u verbindt

Voer één testbetaling uit voordat u live gaat:

1. Maak een product aan en zet zijn Omgeving op Testing. Dat draait het product op uw sandbox-inloggegevens, zodat u een volledige bestelling kunt plaatsen zonder geld te verplaatsen. (Als u de sandbox-set oversloeg, valt een Testing-product terug op live, dus voeg hem eerst toe.)
2. Plaats de buy button op een pagina (een lokaal HTML-bestand werkt) gericht op uw project.
3. Rond de checkout af door te betalen met uw sandbox-koperaccount.
4. Open het tabblad Transacties. Een nieuwe rij verschijnt, gemarkeerd als Testing. Wanneer zijn status succeeded bereikt, werken zowel uw inloggegevens als webhook end-to-end.

Zet de Omgeving van het product op Live wanneer u klaar bent voor echte betalingen.

Problemen oplossen

Begin met Verifiëren. Klik in het dashboard op Verifiëren (of Testinloggegevens verifiëren voor sandbox) om uw client-inloggegevens te controleren.

Verifiëren mislukt.

Kopieer de Client ID en Client secret opnieuw. De sandbox-app en live-app hebben verschillende paren, dus haal ze niet door elkaar.

Betaling voltooit maar de bestelling blijft in behandeling.

De Webhook ID moet uit dezelfde app en omgeving komen als uw client-inloggegevens. Live inloggegevens hebben de live webhook-ID nodig. Bevestig dat de webhook-URL overeenkomt.

Bevestig het end-to-end.

PayPal Developer Dashboard → Webhooks Simulator: stuur een voorbeeld-event naar uw webhook-URL, en kijk dan hoe de bestelling bijwerkt.

Goed om te weten

Secrets roteren. Genereer wanneer u maar wilt een nieuw client secret, plak het dan in. Geheime velden blijven leeg bij bewerken.

Vragen? Join our Discord