Test-Modus

Mit einem Key mit Präfix ratum_test_ entwickelst du gegen dieselbe API (api.ratum.ch), aber ohne Kosten und ohne echte Wirkung. Eine separate Sandbox-Umgebung gibt es nicht und braucht es nicht.

	Live (ratum_live_)	Test (ratum_test_)
E-Mails an Signer	ja (ausser delivery: none)	nie, delivery: none ist erzwungen
Benachrichtigungen an dich	ja	nein
Kontingent / Abrechnung	wird belastet	kostenlos
Versiegeltes PDF	Produktionszertifikat	Wasserzeichen «TEST» auf jeder Seite, nicht vertrauenswürdiges Test-Zertifikat
Langzeitarchiv (IPFS)	ja	nein, das versiegelte PDF liegt bis zur Löschung nur im Working Store von ratum
Aufbewahrung	regulär	Löschung nach 7 Tagen
Tageslimit	geplant: 1 000 Dokumente pro Benutzer und Tag	50 Test-Dokumente pro Benutzer in 24 Stunden (429)
Limit 500 aktive Dokumente	zählt	zählt nicht
Webhooks	livemode: true	livemode: false

So testest du einen kompletten Durchlauf

1. Test-Key erzeugen (Profil → API-Zugang → Modus Test), Scopes inkl. signers:link.
2. Dokument wie im Quickstart senden.
3. Signier-Link per POST /documents/{id}/signers/{sid}/link abrufen und im Browser öffnen. Die Signier-Seite zeigt ein TEST-Banner.
4. Signieren. Danach liefert /download/sealed das PDF mit Wasserzeichen.

Trennung von Live-Daten

Test- und Live-Daten sind strikt getrennt. Ein Live-Key sieht keine Test-Dokumente und umgekehrt: Die IDs fremder Modi liefern 404, und GET /documents listet nur Dokumente des eigenen Modus. Jedes Dokument trägt ein Feld mode (live oder test). Im GUI sind Test-Dokumente mit einem TEST-Badge gekennzeichnet und lassen sich nach Modus filtern.

Was du wissen musst

• delivery wird auf none gezwungen, auch wenn du ratum angibst. Es geht nie eine Mail an Signer oder an dich.
• Überschreitest du das Tageslimit, antwortet die API mit 429 und Retry-After.
• Auf Umgebungen ohne eingerichtetes Test-Zertifikat antwortet die API beim Anlegen eines Test-Dokuments mit 503.
• Die Signier-Seite zeigt ein TEST-Banner. Der Signer sieht damit, dass das Dokument keine rechtliche Wirkung hat.

Ein mit Test-Zertifikat versiegeltes PDF ist keine gültige elektronische Signatur. Es dient nur der Entwicklung.