DRUO
Get started
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:

IntentWhat the payer doesMerchant exchange
connectLinks a bank account for later usePOST /v1/accounts/attach
paymentAuthorizes one payment at checkoutPOST /v1/intents/confirm
buy_nowAuthorizes a payment straight from a product pagePOST /v1/intents/confirm
subscriptionAuthorizes a recurring charge schedulePOST /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>