Marketplace · Extension
Tebex
Ontvang betalingen via Tebex Checkout terwijl producten en prijzen in Agovena beheerd blijven.
Over dit package
Wat het pakket doet
Agovena stuurt custom orderitems naar Tebex Checkout zonder lokale product-naar-package mapping. De payload bevat productnamen, prijzen, quantities en Agovena-metadata. Tebex beheert de provider-hosted betaalpagina en de methoden die aan de klant worden getoond; Agovena opent deze via een redirect. Agovena exposeert één checkoutoptie, tebex:tebex, met het officiële Tebex icon-mark SVG.
De extensie ondersteunt signed webhooks, basket-naar-payment-reconciliatie, volledige refunds en provider-managed recurring payments voor één custom subscription-item. De extensie verzamelt geen kaartgegevens en bouwt geen lokaal kaartformulier.
Verificatiestatus
De extensie is production-ready voor de gedocumenteerde Agovena-integratiescope en wordt gedekt door Agovena’s gerichte providertests. Tebex Checkout API-goedkeuring, Sandbox-checkout, echte webhooks, refunds en recurring lifecycle-gedrag blijven operationele controles aan merchantzijde vóór live klantbestellingen.
Het pakket instellen
Configureer project_id, het geheime secret_key en het geheime webhook_secret. Een product-naar-Tebex-package mapping is niet nodig. De adapter stuurt elk orderitem via Tebexs custom /checkout endpoint.
Registreer:
https://store.example/webhooks/payments/tebex
Tebex ondertekent requests met X-Signature. Agovena beantwoordt de signed validation.webhook handshake met het oorspronkelijke webhook-ID, valideert signed payment-events en houdt dubbele events idempotent.
Grenzen
- Betaalmethoden worden in Tebexs provider-hosted checkout gekozen. Er is geen apart globaal discovery-endpoint voor de Checkout API.
- De checkoutoptie is
tebex:tebex; Agovena verzint geentebex:paypal,tebex:cardoftebex:idealmethoden. - De ordervaluta en het exacte custom itemtotaal moeten overeenkomen met de lokale payment. Orders met niet-ondersteunde tax-, verzend-, kortings-, fee- of mixed-currencytotalen worden geweigerd.
- De eerste basket-ID is geen refundtransaction. Refunds vereisen de geverifieerde
tbx-payment transaction. - Recurring checkout vereist exact één subscription-item met quantity één, heeft geen ondersteunde trialmapping en mag geen one-time items mengen.
- Cancellation is alleen period-end totdat de authoritatieve provider-webhook de eindstatus bevestigt.
- Chargebacks blijven pending voor manual reconciliation en worden niet als refund gefabriceerd.
- Refunds zijn alleen volledig en vereisen het oorspronkelijke bedrag en de oorspronkelijke valuta. Deelrefunds worden geweigerd.
Foutafhandeling
Onbekende checkout- en refunduitkomsten blijven in reconciliatiestatus. Een retry mag niet als provider-idempotent worden behandeld totdat Tebexgedrag in Sandbox is geverifieerd. Afwijkende webhookitems, bedragen, valuta of refunddata worden gedeferd en niet als succesvol opgeslagen.