Zintegruj TEF.

Twoja działalność stacjonarna
wzmocniona dzięki IOPAY

Integracja podzielona na dwie dobrze określone warstwy.

TEF widoczny odbywa się lokalnie pomiędzy Twoja Aplikacja, Zoop i PINPad. Jednakże operacja płatności nadal jest zintegrowana z IOPAY. To zachowuje jedną warstwę do konta, zarządzania transakcjami, aktywacji terminału, wydarzeń i webhooks.

Kto co robi w integracji.

Poniższe oddzielenie uniemożliwia wykorzystanie komponentu Zoop do wykonywania lokalnych zdjęć do zamiany głównej integracji operacyjnej.

SDK Embedded lub Desktop Server.

Istnieją dwa udokumentowane sposoby wdrożenia lokalnej warstwy. Obie zachowują tę samą architekturę IOPAY do kont, aktywacji i wydarzeń.

Od pustych projektów do pierwszej płatności w pięciu krokach.

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 zintegrowany bezpośrednio z PDV.

W tym podejściu składnik wychwytu znajduje się w Twoja Aplikacja. Plugin lokalnie rozmawia z PINPadem, podczas gdy operacja nadal jest powiązana z infrastrukturą IOPAY.

Wykonane po aktywacji

Po tym jak marketplace, seller i accessKey jeśli zostały odzyskane i utrzymane, użyj tych wartości w czasie uruchomienia do ponownego uruchomienia SDK. Nie należy je wpisywać ręcznie przez operatora.

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

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

Stan integracji

Token powstaje w SDK i związek jest zakończony w IOPAY.

Aktywacja łączy urządzenie z prawidłowym kontem. Ten krok musi nastąpić przed pierwszą transakcją i musi być testowany również po ponownym uruchomieniu Twoja Aplikacja.

Sprawdź klucz transakcyjny przed opłatą.

Klucz transakcyjny Zoop musi znajdować się w PINPad, aby dokonywać płatności kartą. W przypadku nieobecności, włączyć IOPAY w celu koordynacji poprawy z dostawcą urządzenia.

Przykład płatności za pomocą karty

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)

Używaj również pośrednich wiadomości z przepływu, aby wyświetlić operatorom instrukcje, takie jak zbliżenie, wprowadzenie lub odczytywanie karty. Powrót lokalny pozwala PDV śledzić, co dzieje się w terminalu.

Co pozostaje wynikiem

Alternatywa za pośrednictwem lokalnego WebSocket.

Zoop Desktop Server działa jak lokalna usługa i wystawia WebSocket na Twoja Aplikacja. Jego celem pozostaje wychwytywanie TEF. Akredytacja, konto, webhooks i przepływ transakcji pozostają na platformie IOPAY.

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>"
}

Twoja Aplikacja nadal odbiera zdarzenia z IOPAY.

Dodanie TEF nie zmienia umowy integracji asynchronicznej: Twoja Aplikacja nadal otrzymuje webhooks z IOPAY z każdego wydarzenia i transakcji zgodnie z umową integracji. SDK/Server zwrot lokalny uzupełnia doświadczenie PDV; nie eliminuje warstwy zdarzeń IOPAY.

Zalecany model korelacji

Naucz się na błędy przed zatwierdzeniem.

Nie waż się tylko scenariuszem zatwierdzenia Pilota musi rozważyć błędy komunikacyjne, upływ tokenu, przerwę podczas wychwytu, ponowne uruchomienie aplikacji i odwołania

Dane aktywacyjne powinny pozostawać poza interfejsem i logami.

marketplace, seller i accessKey są częścią technicznego uruchomienia urządzenia. Twoja Aplikacja powinien je chronić i automatycznie je używać po aktywacji.

Checklist przed zwolnieniem pilota.

Oficjalna dokumentacja do wdrożenia.

Użyj poniższych wytycznych jako odniesienia technicznego do wersji komponentu zainstalowanej w projekcie. Parametry, kompatybilność, wersje i protokoły mogą się zmieniać; zawsze potwierdź oficjalną dokumentację podczas wdrażania.