Bring die Währungen der XDR⁵-MATRYX als Zahlungsmittel in deinen Shop — ein künstlerisches, eigenständiges Währungssystem.
Es gibt zwei, und sie tun Verschiedenes:
| TRYX | die Währung der MATRYX | Nutzer „öffnen" Räume in einer interaktiven Karte. Zahlt jemand mit TRYX, fallen seine Räume in die Karte zurück — niemand bekommt sie. |
| KINISI (KIN) | die Bewegungswährung | Entsteht dadurch, dass in der MATRYX etwas geschieht. Zahlt jemand mit KIN, landet der Betrag auf dem Konto deines Ladens — du kannst ihn ausgeben, verschenken oder in Räume tauschen. |
Dieses Repository enthält Dokumentation und Beispielcode, mit dem Shopbetreiber beides als Zahlungsoption anbieten können.
Live: xdr5.de · kinisi.xdr5.de · Was sind TRYX? FAQ
| Variante | Wofür |
|---|---|
| Hosted Checkout (empfohlen) | Drei Zeilen JavaScript, der „Mit TRYX bezahlen"-Button erscheint automatisch. Keine eigene Server-Logik nötig. |
| JSON-API | Volle Kontrolle, Payment-Intents serverseitig erzeugen und bestätigen. Für komplexere Shop-Systeme. |
Komplette Doku: INTEGRATION.md
Auf deiner Bezahlseite einfügen:
<script>
var xdr5_amount = 7;
var xdr5_v_1 = ["Bestellnummer", "ABC-123"];
var xdr5_v_2 = ["E-Mail", "kunde@example.de"];
var xdr5_return_url = "https://deinshop.de/danke/";
</script>
<script src="https://xdr5.de/api/xdr5_checkout.js"></script>Auf deiner Danke-Seite reicht:
<div id="xdr5-tryx-result"></div>
<script src="https://xdr5.de/api/xdr5_checkout.js"></script>Fertig. Der Rest läuft auf der XDR⁵-Plattform.
Komplette Doku: KINISI.md
KINISI folgt demselben Muster — Intent anlegen, Kunde umleiten, Beleg prüfen. Wer TRYX angebunden hat, erkennt alles wieder. Drei Unterschiede muss man aber kennen, sonst läuft man auf:
- Es gibt keinen Knopf zum Einkleben. Kein
kinisi_checkout.js, keine drei Zeilen HTML — die Datei existiert nicht und hat nie existiert. Der Grund: Das Anlegen einer Zahlung braucht deinen Shop-Schlüssel, und der darf nie in den Browser. Der Weg ist serverseitig, in drei Schritten. - Es gibt kein Empfängerfeld. Wohin das Geld geht, hängt am Schlüssel, nicht an der Anfrage. Sonst könnte jeder mit irgendeinem gültigen Schlüssel Zahlungen auf fremde Konten ausstellen.
- Ein Endpunkt für alles:
POST /api/kinisi_json.php, die Aktion steht im Feldaction— nicht je Aktion eine eigene Datei wie bei TRYX.
Zur Verbindung: Basis ist
https://kinisi.xdr5.de/api/kinisi_json.php. Die Domain trägt ein reguläres Zertifikat — lass die Prüfung in deinem Client eingeschaltet. Ein Aufruf überhttp://wird aufhttps://umgeleitet, und ein Client, der dabei wie üblich von POST auf GET umstellt, verliert den Rumpf und bekommt eine 403. Nimm gleichhttps://.
Funktionierende Beispieldateien im Ordner examples/:
hosted-checkout.html— TRYX: Bezahlseite mit Buttonthank-you.html— TRYX: Danke-Seite mit Ergebnisanzeigeserver-side.php— TRYX: Serverseitige Integration via JSON-APIkinisi-server-side.php— KINISI: Serverseitige Integration, mit den Prüfungen aus KINISI.md §6
- TRYX-Beträge werden auf der XDR⁵-Plattform abgewickelt — du brauchst keine Zahlungsdaten zu verwalten.
- Du entscheidest selbst, welche Bestelldaten (Name, E-Mail, Bestellnummer …) du in den
xdr5_v_*-Feldern übergibst. - Die Bestelldaten werden zusätzlich im LocalStorage des Browsers abgelegt, damit die Danke-Seite die Bestellung anzeigen kann.
Details siehe INTEGRATION.md, Abschnitt „Datenübertragung & Speicherung".
MIT — die Beispiele dürfen frei kopiert und angepasst werden.
Hinweis: Die XDR⁵-Plattform und die Währungen TRYX und KINISI selbst sind ein künstlerisches Projekt von Foerb und stehen nicht unter der MIT-Lizenz.