Skip to content
foerbsnaviPublic

About

TRYX als Zahlungsmittel in den eigenen Shop einbinden — Hosted-Checkout-Script und JSON-API für die XDR⁵-Plattform.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

XDR⁵ — TRYX & KINISI Payment Integration

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

Zwei Wege zur Integration

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

Quickstart: TRYX-Button in 30 Sekunden

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.

KINISI (KIN) einbinden

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:

  1. 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.
  2. 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.
  3. Ein Endpunkt für alles: POST /api/kinisi_json.php, die Aktion steht im Feld action — 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 über http:// wird auf https:// umgeleitet, und ein Client, der dabei wie üblich von POST auf GET umstellt, verliert den Rumpf und bekommt eine 403. Nimm gleich https://.

Beispiele

Funktionierende Beispieldateien im Ordner examples/:

Was passiert mit den Daten?

  • 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".

Lizenz

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.

About

TRYX als Zahlungsmittel in den eigenen Shop einbinden — Hosted-Checkout-Script und JSON-API für die XDR⁵-Plattform.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors