Tebex

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:

text

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 geen tebex:paypal, tebex:card of tebex:ideal methoden.
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.

Open de providerhandleiding