TEF integrieren.

Ihr Betrieb vor Ort
gestärkt durch IOPAY

Eine gut definierte Integration in zwei Schichten

TEF-Einschlag findet lokal zwischen Ihre Anwendungdie Komponente Zoop und PINPad Die Zahlungsabwicklung ist jedoch weiterhin integriert in IOPAY Dies speichert eine einzige Schicht für Konto, Transaktionsmanagement, Terminalaktivierung, Events und Webhooks

Wer tut was bei der Integration

Die Abspaltung unten verhindert, dass die Verwendung des Zoop-Komponents für die Lokalisierung mit einem Austausch der Hauptintegration der Operation verwechselt wird

SDK Embedded oder Desktop Server

Es gibt zwei dokumentierte Möglichkeiten, die lokale Schicht zu implementieren Die beiden erhalten die gleiche IOPAY-Architektur für Konten, Aktivierungen und Veranstaltungen

Von einem leeren Projekt bis zur ersten Zahlung in fünf Schritten

implementation(
    "br.zoop.pos.plugin:zoop-pos-plugin-desktop-jvm:X.Y.Z"
)

Zoop.initialize(context)

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

val activationRequest =
    ZoopFoundationPlugin
        .createDashboardActivationRequestBuilder()
        .tokenCallback(/* receber e exibir o token */)
        .confirmCallback(/* persistir dados confirmados */)
        .build()

Zoop.post(activationRequest)

{
  "marketplace": "<retornado-na-ativacao>",
  "seller": "<retornado-na-ativacao>",
  "accessKey": "<retornado-na-ativacao>"
}

Zoop Desktop SDK integriert direkt in den PDV

In diesem Ansatz befindet sich die Fächerkomponente in Ihrer Anwendung Das Plugin spricht lokal mit dem PINPad, während der Betrieb weiterhin an die IOPAY-Infrastruktur gebunden ist

Einführung nach der Aktivierung

Nach dem marketplace, seller und accessKey Wenn sie wiederhergestellt und bestanden sind, verwenden Sie diese Werte zur Laufzeit, um das SDK neu zu starten Sie dürfen nicht manuell von dem Betreiber eingetragen werden

Zoop.initialize(context) {
    credentials {
        marketplace = storedMarketplace
        seller = storedSeller
        accessKey = storedAccessKey
    }
}

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

Integrationszustand

Das Token wird in SDK geboren und der Link wird in IOPAY abgeschlossen

Aktivierung verbindet das Gerät zum richtigen Konto Dieser Schritt muss vor dem ersten Transaktionsvorgang stattfinden und muss auch nach dem Neustart Ihres Anwendens getestet werden

Berichten Sie sich mit dem Transaktionsschlüssel, bevor Sie eine Gebühr erheben

Der Transaktionsschlüssel Zoop muss im PINPad vorhanden sein, damit Kartenzahlungen ausgeführt werden Wenn Sie ausstehen, aktivieren Sie IOPAY, um die Korrektur mit dem Equipment-Anbieter zu koordinieren

Beispiel für Kartenerhebung

val paymentRequest = DesktopPlugin
    .createPaymentRequestBuilder()
    .amount(1000)              // R$ 10,00 — valor em centavos
    .option(Option.CREDIT)
    .installments(2)
    .referenceId("pedido-84217")
    .callback(/* tratar sucesso e falha */)
    .build()

Zoop.post(paymentRequest)

Handelt auch mit Fluss-Mitteilungen um Anweisungen wie Annäherung, Einfügung oder Kartenlesen an den Betreiber anzuzeigen Local Return ermöglicht dem PDV, mit dem Terminal zu verfahren

Was bleibt aus dem Ergebnis

Alternative über lokale WebSocket

Der Zoop Desktop Server läuft wie ein lokales Service und stellt ein WebSocket für Ihre Anwendung dar Ihr Ziel ist weiterhin TEF-Fang Akkreditierung, Konto, Webhooks und Transaktionsfluss bleiben auf den IOPAY-Plattformen

java -version

ws://localhost:1337

const socket = new WebSocket('ws://localhost:1337');

socket.onopen = () => {
    console.log('Desktop Server conectado');
};

socket.onmessage = (event) => {
    const message = JSON.parse(event.data);
    handleZoopMessage(message);
};

socket.onerror = (error) => {
    handleSocketError(error);
};

socket.onclose = () => {
    handleSocketClosed();
};

{
  "type": "activation"
}

{
  "type": "initialize",
  "marketplace": "<valor recebido na ativacao>",
  "seller": "<valor recebido na ativacao>",
  "accessKey": "<valor recebido na ativacao>"
}

Ihre Anwendung empfängt weiterhin Ereignisse von IOPAY.

TEF hinzufügen ändert den Asynchron-Integrationsvertrag nicht: Ihre Anwendung erhält weiterhin von IOPAY die Webhooks für jedes Ereignis und jede Transaktion gemäß der vereinbarten Integration SDK/Server Local Return ergänzt das PDV-Erlebnis; es eliminiert nicht die IOPAY-Ereignis-Layer

Rekommendedes Korrelationsmodell

Üben Sie Fehler vor der Genehmigung

Validieren Sie nicht nur den Zulassungsszenario Der Pilot muss Kommunikationsfehler, abgelaufene Token, Unterbrechung während der Aufnahme, Neustart der Anwendung und Stornierungen berücksichtigen

Aktivierungsdaten müssen außerhalb der Schnittstelle und der Logs bleiben

Marktplatz, Verkäufer und AccessKey sind Teil des technischen Starts des Geräts Sie müssen sie automatisch nach dem Aktivieren schützen und verwenden

Checklist vor der Freilassung des Piloten

Offizielle Implementierungsdokumentation

Verwenden Sie die folgenden Leitfäden als technische Referenz für die Version des in dem Projekt installierten Komponents Parameter, Kompatibilität, Versionen und Protokolle können sich weiterentwickeln; die offizielle Dokumentation wird immer während der Implementierung validiert