PayPal

Over dit package

Wat het pakket doet

PayPal wordt als één checkoutoptie aangeboden met het officiële extension-owned PayPal SVG-icoon. Storefront-checkout opent de officiële PayPal JS SDK-popup-overlay; de SDK beheert approval en Agovena stuurt de klant na onApprove, onCancel of onError terug naar de statusafhandeling. Signed webhooks blijven leidend. Automatische recurring checkout slaat tijdens de eerste Orders v2-betaling een Vault-autorisatie op en Core voert latere renewal-orders uit met vault_id en stored_credential. Een Billing Plan-ID is niet nodig.

De extension ondersteunt volledige en gedeeltelijke capture-refunds voor initiële en recurring Orders v2-payments. Provider capture-referenties worden bewaard, bedrag en valuta worden gecontroleerd wanneer beschikbaar, PayPal idempotency keys worden doorgegeven, verwijderde vault authorizations worden ingetrokken en onbekende outcomes gaan naar reconciliatie. Een vooraf aangemaakte Billing Plan is niet nodig.

Vereisten

Agovena Core ^0.0.1. Configureer een PayPal-applicatie, een geregistreerde webhook en de bijbehorende Sandbox- of liveomgeving. Provideraccountgoedkeuring, webhookdelivery en live transactieverwerking blijven verantwoordelijkheden van de deployment.

Lokale adapter-, API-contract- en lifecycletests dekken de implementatie. Een echte PayPal-checkout, webhookdelivery, refund, recurring renewal en merchant approval blijven deployment-verificatiestappen en worden niet als uitgevoerd geclaimd.

Het pakket instellen

Stel client_id, het geheime client_secret en webhook_id in vanuit dezelfde PayPal-applicatie en omgeving. sandbox staat standaard aan. Registreer de Agovena-betaalwebhook bij die applicatie. Een webhook-ID identificeert het geregistreerde endpoint en is niet het clientgeheim of een lokaal verzonnen ondertekeningssleutel.

Activeer de subscribable product capability voor automatische renewals. De eerste checkout vraagt een merchant vault authorization aan. Latere renewals gebruiken de encrypted authorization die de PayPal-extension bewaart. Er is geen subscription_plan_id en geen product-level PayPal-planinstelling.

Werking en foutafhandeling

Webhookverificatie gebruikt PayPal’s verify-webhook-signature-operatie en accepteert alleen PayPal HTTPS-certificaathosts. Een geverifieerde approval-webhook voert capture uit voordat Agovena de payment als betaald markeert. Een recurring authorization wordt alleen opgeslagen wanneer de capture een succesvolle vaultrespons bevat.

Refunds gebruiken Orders capture-ID’s voor zowel initiële als recurring payments. PAYMENT.CAPTURE.REFUND.* werkt de Agovena-refund bij. Vault deletion-events trekken de lokale authorization in. Een redirect is geen betalingsbewijs. Mismatches in bedrag of valuta, ongeldige providerreferenties, mislukte refunds en onbekende transportoutcomes worden niet automatisch succesvol opgeslagen.

Open de providerhandleiding