> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getruba.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Publish Buy Links
> Configure a reusable URL that creates a fresh checkout for every visit.
export const RubaSocials = () => {
if (typeof document === "undefined") {
return null;
}
const inject = () => {
const footer = document.getElementById("footer");
if (!footer || document.getElementById("ruba-socials")) {
return false;
}
const isDark = document.querySelector("html.dark") || document.querySelector('html[class*="dark"]');
const lineColor = isDark ? "#383838" : "#e8e8ed";
const iconColor = isDark ? "#8e8e93" : "#86868b";
const markColor = isDark ? "#ffffff" : "#08080c";
const hoverColor = "#0071e3";
const div = document.createElement("div");
div.id = "ruba-socials";
div.style.cssText = `display:flex;align-items:center;gap:20px;padding-top:20px;margin-top:20px;border-top:1px solid ${lineColor};width:100%`;
const logo = `Ruba`;
const spacer = ``;
const ig = ``;
const li = ``;
const x = ``;
const github = ``;
div.innerHTML = logo + spacer + ig + li + x + github;
footer.appendChild(div);
return true;
};
if (!document.documentElement.dataset.rubaSocialsObserver) {
document.documentElement.dataset.rubaSocialsObserver = "true";
const observer = new MutationObserver(() => {
if (!document.getElementById("ruba-socials")) {
inject();
}
});
observer.observe(document.body, {
childList: true,
subtree: true
});
}
setTimeout(() => {
if (!inject()) {
const interval = setInterval(() => {
if (inject()) {
clearInterval(interval);
}
}, 500);
setTimeout(() => clearInterval(interval), 10000);
}
}, 300);
return null;
};
A buy link is the no-backend route into Ruba checkout. Configure the commercial defaults once, then place the URL in a pricing page, campaign, email, social post, or product button.
Use the [Checkout Session API](/features/checkout/session) instead when your server must calculate customer-specific values before checkout opens.
## System flow
The reusable link and the checkout it creates are different records:
1. The link stores products, optional discount, trial, seats, redirect targets, and metadata.
2. Each visit copies those settings into a new short-lived checkout session.
3. The buyer completes that generated session.
Share the buy-link URL. A session URL is temporary and should never replace it in permanent UI or campaign copy.
## Build a Checkout Link
Open [**Products → Checkout Links**](https://getruba.com/to/dashboard/products/checkout-links) and select **New Link**.
### Decide what the buyer can choose
Add one product for a fixed route, or several products to display a selector in the order you provide. The buyer still purchases exactly one product; this is a choice interface, not a multi-item cart.
### Decide what Ruba applies automatically
* **Discount:** apply one discount without asking the buyer for a code. If discount-code entry is enabled, they may also enter a code manually.
* **Trial:** override the products’ normal trial only for sessions created by this link.
* **Seats:** lock a member-priced checkout to one quantity. If later product limits no longer accept it, Ruba ignores the preset and restores buyer selection.
* **Metadata:** copy internal key-value context into the session and then into the resulting order or subscription.
### Decide where navigation goes
* **Success URL:** redirect after payment. Include `checkout_id={CHECKOUT_ID}` when the destination needs the completed session identifier.
* **Return URL:** show a back action that returns to your pricing or product surface. Without this value, checkout has no back button.
## Query parameters
Query values modify one visit without editing the stored link.
### Product and form state
Select one of the products already attached to the link. The buyer may still switch before paying.
Place an email address into the checkout form.
Place a customer name into the checkout form.
Fill the visible code field with a coded discount. This differs from a link-level discount, which is applied silently.
Set the starting amount for a pay-what-you-want product.
Fill one custom field, replacing `{slug}` with that field’s slug.
### Presentation
Choose an IETF BCP 47 locale such as `en`, `fr`, or `pt-BR`. Browser language is used when omitted.
Choose `light` or `dark`. Without an override, checkout follows the buyer’s system preference.
### Attribution and reconciliation
Ruba copies these values into checkout metadata:
Your application’s identifier for this checkout.
Campaign source.Campaign medium.Campaign name.Campaign content variant.Campaign search term.