Payplug Elements

Payplug Elements are new HTML elements you embed to drive a payment session, in full or split payment: the customer settles one order in one or several tranches until the total is covered (ANCV then the rest on card, a partially authorized card then the rest on Wero…).

Payplug Elements are powered by the split-payment orchestrator, which holds every tranche as an authorization and only captures once the whole order is covered: a customer is never charged for an incomplete order.

What Payplug Elements give you

• The complete checkout journey, ready-made: amount choice (total or partial with shortcuts), the authorized/remaining loop, post-tranche and refusal banners, a single waiting screen while an authorization is pending, per-tranche cancel, global abandon, and the final screens (confirmed, abandoned, expired).
• Failures handled: a refused authorization charges nothing and leaves the already-authorized tranches valid; abandon and expiry release every pending authorization.
• Your page stays in charge: plain web components in light DOM. You choose your own layout, and the theme brings them in line with your brand.
• EU-ready: i18n with lazy-loaded language catalogs, locale-aware amount formatting, one currency per session.
• Try before you build: this documentation embeds the real components on genuine sandbox sessions: the playground runs the exact deliverable you will load.

How the documentation is organized

1. How it works the big picture in one diagram: what happens during a split payment, the four tasks that fall to you, and what Payplug Elements handle.
2. Create a session the two calls made by your server, and the token it hands to your page.
3. Show the elements one script, one root element, the elements you compose.
4. Webhooks our call to your server when a session ends.
5. Playground play with Payplug Elements, live on the page, on a sandbox session: try splitting, successes and failures, and restyle the elements with the theme editor.
6. Styling matching your brand with the design tokens, and the structural override recipes.
7. Payment methods configuring card, Apple Pay, PayPal, Wero, ANCV and Oney: partial authorization policies, BNPL plans, amount windows.
8. Feature flags split payment, per-tranche cancel, and the final-screen layout.
9. Languages & currency 25 languages, browser-language detection, locale-aware amounts.
10. Element reference the exhaustive API surface of the elements.
11. HTTP API reference the orchestrator’s contract, one page per operation with request samples.