Simple Integration
Embed Button
One <script> tag and one <button> — that's it. Style it to match your brand.
Copy & paste
<script src="https://cdn.vaulty.world/embed.v1.js" async></script>
<button
data-vaulty-pay
data-partner="YOUR_PARTNER_ID"
data-amount="12.50"
data-token="USDC"
data-ref="order_8721">
Pay with Vaulty
</button>Styling options
- data-theme="dark" | "light" | "auto"
- data-shape="pill" | "square"
- data-size="sm" | "md" | "lg"
- data-label — replace the default button text
- Or wrap your own button: add data-vaulty-pay to any element.
Listening for results
window.addEventListener('vaulty:paid', (e) => {
console.log(e.detail.signature, e.detail.ref);
});
window.addEventListener('vaulty:cancelled', () => { /* ... */ });Testing
- Use data-env="sandbox" to route through testnet.
- Open browser devtools — the embed logs lifecycle events under [vaulty].
- Test on mobile to verify the in-app handoff works.
