Components
Overview & installation
Drop DRUO's bank payment and account connection experience into any page with one script tag.
Overview
DRUO Components is a drop-in surface that a merchant adds to any page with one script tag. It renders a DRUO-managed experience inside the merchant's DOM: the payer never leaves the funnel, and there is no hosted checkout page.
DRUO is a single payment method. The component renders only the DRUO experience — it never renders card, PSE or wallet options. Method selection, cart, totals, shipping and every other piece of page chrome belong to the merchant layer.
Four intents, each its own thing:
| Intent | What the payer does | Merchant exchange |
|---|---|---|
connect | Links a bank account for later use | POST /v1/accounts/attach |
payment | Authorizes one payment at checkout | POST /v1/intents/confirm |
buy_now | Authorizes a payment straight from a product page | POST /v1/intents/confirm |
subscription | Authorizes a recurring charge schedule | POST /v1/intents/confirm |
Every intent returns the same intent-agnostic shape: a single-use resultToken plus an intentUuid. Nothing is named "payment", because most intents are not one.
Installation
html
<script src="https://js.druo.com/v1/components.js" data-key="pk_live_..."></script>
<!-- Declarative -->
<div data-druo-component="payment"
data-component-id="cmp_9f2"
data-amount="4820"
data-currency="USD"
data-order-id="NW-10422"
data-customer-ref="cus_merchant_771"></div>
<!-- or programmatic -->
<script>
const checkout = Druo.mount("#druo-checkout", {
publishableKey: "pk_live_...",
componentId: "cmp_9f2",
intent: "payment",
mode: "inline",
amount: 4820,
currency: "USD",
orderId: "NW-10422",
merchantCustomerRef: "cus_merchant_771",
allowSaveAccount: true,
});
checkout.on("success", (r) => confirmOnServer(r.paymentToken));
</script>
