Integrér TEF.

Din fysiske drift
styrket med IOPAY

En veldefineret todelt integration

TEF in- person fangst finder sted lokalt mellem Din ApplikationZoop-komponenten og PINPad Betalingstransaktionen er dog fortsat integreret i IOPAY. Dette bevarer et enkelt lag for konto, transaktionsstyring, terminalaktivering, begivenheder og webhooks

Hvem gør hvad i integration

Den nedenfor beskrevne adskillelse forhindrer, at anvendelsen af Zoop-komponenten til lokal opsamling forveksles med en udveksling af hovedintegreringen af operationen

SDK Indlejret eller desktopserver

Der er to dokumenterede måder at implementere det lokale lag Begge bevare den samme IOPAY arkitektur for konto, aktivering og begivenheder

Fra det tomme projekt til den første betaling i fem trin

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 integreret direkte i PDV

I denne tilgang, er capture komponent inden for Din Applikation plugin konverterer lokalt med PINPad, mens operationen forbliver knyttet til IOPAY infrastruktur

Indledning efter aktivering

Derefter marketplace, seller og accessKey Hvis de er blevet genvundet og vedholdende, skal du bruge disse værdier i drifttid til at genstarte SDK De må ikke manuelt indtastes af operatøren

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

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

Integrationstakt

Mønsteret er født i SDK og linket er afsluttet i IOPAY

Aktivering forbinder enheden med den korrekte konto Dette trin skal ske før den første transaktion og skal testes også efter du genstarter din ansøgning

Konsultér transaktionsnøglen før opladning

Zoop transaktionsnøglen skal være i PINPad for kortbetalinger der skal udføres Hvis du er fraværende, skal du trykke på IOPAY for at koordinere korrektionen med udstyrsleverandøren

Eksempel på kortopladning

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)

Behandl også strømmen mellemliggende meddelelser til at vise operatøren instruktioner såsom nærmer sig, indsætter eller læser kortet Lokal feedback tillader PDV at holde styr på, hvad der sker i terminalen

Hvad der fortsætter af resultatet

Alternativ via lokal WebSocket

Zoop Desktop Server kører som en lokal tjeneste og udsætter en WebSocket til Din Applikation Dit omfang fortsætter med at være TEF capture Akkreditering, konto, webhooks og transaktionsstrøm forbliver på IOPAY platforme

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

Din Applikation modtager fortsat hændelser fra IOPAY.

Tilføjelse af TEF ændrer ikke den asynkrone integration aftale: Din Applikation fortsætter med at modtage webhooks fra IOPAY for hver begivenhed og transaktion i henhold til den aftalte integration SDK / Server Local Return supplerer PDV oplevelse; det fjerner ikke IOPAY begivenhed lag

Anbefalet korrelationsmodel

Træningsfejl før godkendelse

Lad være med at validere godkendelsesscenariet Piloten skal overveje kommunikationsfejl, udløbet token, afbrydelse under opsamling, genstart ansøgning og aflysninger

Aktiveringsdata skal forblive uden for grænsefladen og logfiler

markedsplads, seller og accessKey er en del af den tekniske opstart af enheden Din Applikation skal beskytte og bruge dem automatisk efter aktivering

Checkliste før frigivelse af piloten

Officiel dokumentation for gennemførelsen

Brug vejledningen nedenfor som en teknisk reference for versionen af komponenten installeret i projektet Parametre, kompatibilitet, versioner og protokoller kan udvikle sig; altid validere officiel dokumentation under gennemførelsen