Paddle

Over dit package

Wat het pakket doet

Gebruik Paddle Billing overlay checkout met orderprijzen. Agovena stuurt orderdata zonder product-ID-mapping, ondersteunt volledige en gedeeltelijke refunds en kan automatic subscriptions via Paddle Billing aanmaken. Paddle blijft eigenaar van de checkout, terwijl Agovena method-specifieke opties toont en Paddle's transaction preview controleert voordat een gefilterde overlay wordt geopend. 2

Vereisten

Agovena Core ^0.0.1. Het manifest noemt geen extra pakketafhankelijkheid. Een provideraccount en toegang tot de externe dienst staan los van de pakketinstallatie. 1

Deze uitbreiding is productierijp voor de ondersteunde Paddle Billing-werkwijze wanneer publieke HTTPS-oorsprong, Paddle-omgeving, client-side token, API-key en webhookdestination consistent zijn geconfigureerd. Rond de Sandbox- of live-accountgoedkeuring en providerverificatie af voordat je echte orders accepteert.

Het pakket instellen

Configureer api_key, client_token, webhook_secret en sandbox. Sandbox staat standaard aan. Configureer de Paddle Default payment link als de publieke Paddle.js-launcher op /paddle/checkout; webhookverwerking kan niet worden uitgeschakeld. Een mapping tussen Agovena-product-ID’s en Paddle-prijs-ID’s is niet nodig.

Lokaal testen met statussynchronisatie

Paddle vereist een publieke HTTPS-oorsprong voor een volledige test, omdat zijn servers webhooks moeten kunnen leveren. Een lokale localhost-URL wordt alleen testbaar via een publieke tunnel zoals Cloudflare Tunnel of ngrok. Rond een Paddle Sandbox-checkout af via de publieke launcher-URL en controleer daarna de order- en webhooklifecycle in Agovena.

Werking en foutafhandeling

Een lege bestelling verhindert checkoutaanmaak. Paddle ontvangt het ordertotaal als inline prijs en geeft een providernummer voor de transactie terug. Bij een betaalde webhook worden betaal- en bestelreferentie, valuta, eindtotaal en het gegenereerde transactieregeltotaal vergeleken. Partial refunds gebruiken Paddle adjustments en vereisen het transaction line-item-ID. Automatic subscriptions gebruiken een inline billing_cycle; Paddle beheert daarna de renewal lifecycle. Controleer een onbekende verzoekuitkomst voordat je een nieuwe transactie begint. 2

Open de providerhandleiding