> ## 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.
# Build Safely in the Sandbox
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 standalone environment, kept apart from your live production data
To try out Ruba or build out your integration without stressing over real money movement or damaging your live organization, you can use our [testing environment](https://sandbox.getruba.com/start).
It is a dedicated server, fully separated from the production instance, where you can run as many experiments as you like.
**Why a separate environment instead of a test mode?**
Because we handle money and must account for every movement to maintain our Merchant of Record service, we found it safer to wall off live data from test data so they never mix. On top of that, it lets you spin up an unlimited number of accounts and organizations to try out plenty of scenarios. Treat it as your personal development server!
## Getting underway
You can reach the testing environment directly at [sandbox.getruba.com](https://sandbox.getruba.com/start) or by clicking `Go to sandbox` inside the organization switcher.
After that, you will need to set up a dedicated user account and organization, following the same steps outlined in our [Quick Start guide](/introduction).
### Trying out payments
The testing environment lets you walk through the entire customer journey, including checkout. You can run test payments using Stripe's [test card numbers](https://docs.stripe.com/testing#cards).
The simplest way to simulate a successful payment is to use the card number below with a future expiration date and a random CVC:
```
4242 4242 4242 4242
```
## API and SDK
To send requests to our [API](/api-reference), all you need to do is point the base URL away from `https://api.getruba.com` and toward `https://sandbox-api.getruba.com`. You will also have to generate an access token inside the **testing environment**, since a token created in production cannot be used in the sandbox.
Our official SDK supports the testing environment via a dedicated parameter.
```ts TypeScript theme={"system"}
const ruba = new Ruba({
server: 'sandbox',
accessToken: process.env['RUBA_ACCESS_TOKEN'] ?? '',
})
```
```py Python theme={"system"}
s = Ruba(
base_url="https://sandbox-api.getruba.com",
access_token="",
)
```
```go Go theme={"system"}
import rubago "github.com/Rubadot/ruba-go"
s := rubago.New(
rubago.WithServer("sandbox"),
rubago.WithSecurity(os.Getenv("RUBA_ACCESS_TOKEN")),
)
```
```php PHP theme={"system"}
$sdk = Ruba\Ruba::builder()
->setServer('sandbox')
->setSecurity(
''
)
->build();
```
## Known caveats
The caveats below apply solely to the sandbox and do not reflect the production behavior.
* Customer-facing emails (order confirmations, subscription renewal reminders, and so on) are only sent to recipients who belong to your organization. Manage these in [**Settings → Members**](https://getruba.com/to/dashboard/settings/members). Sub-addressing aliases like `you+test@example.com` are allowed.