Integreeri TEF.

Sinu kohapealne tegevus
võimendatud IOPAY abil

Üksindamine, mis on jagatud kaheks selgelt määratletud laagiks.

TEF isiklik kinnipeamine toimub kohapeal vahel Sinu Rakendus, Zoop-komponent ja PINPad. Makse tehing jääb siiski IOPAY integreeritud. See säilitab ühe laadi konto, tehingute haldamise, terminali aktiveerimise, sündmuste ja webhooks jaoks.

Kes teeb mida integreerimisel.

Allpool kirjeldatud eraldamine välistab Zoop osa kasutamist kohapealse püügi jaoks segadusse ajamise peamise operatsiooni integreerimise vahetamisega.

SDK-i sisestatud või Desktop Server.

Seal on kaks dokumenteeritud viisi kohalikku katmist rakendada. Mõlemad säilitavad sama IOPAY arhitektuuri arvestamiseks, aktiveerimiseks ja sündmustele.

Vaevalt projektist kuni esimesele maksele viie sammuga.

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 integreeritud otse PDV-sse.

Selle lähenemisviisi puhul on püügikomponent Sinu Rakendus. Plugin räägib PINPadiga kohapeal, samal ajal kui toiming on veel seotud IOPAY infrastruktuuriga.

Autamine pärast aktiveerimist

Seejärel marketplace, seller ja accessKey kui need on taastatud ja jätkatud, kasutage neid väärtusi jooksval ajal SDK uuesti käivitamiseks. Neid ei tohi operaator käsikäeliselt kirjutada.

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

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

Integratsiooni seisund

Token sündib SDK-l ja seos lõpeb IOPAY-l.

Aktiveerimine ühendab seadme õigese kontoga. See samm peab toimuma enne esimest tehingut ja peab olema testitud ka pärast Sinu Rakendus uuesti käivitamist.

Kontrollige tehingukähe enne tasumist.

Transaktsionaalne võti Zoop peab olema PINPadis, et teha kaardiga makseid. Kui see pole olemas, lülitage IOPAY, et korrigeerida seadme tarnijaga.

Kaardi tasumise näide

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)

Samuti käsitlevad vahekordseid voolu sõnumid, et näidata operaatorile juhiseid, nagu lähenemine, sisestamine või kaardi lugemine. Kohalik tagasisaatmine võimaldab PDVil jälgida, mis toimub terminali juures.

Mida tulemusest jääb

Alternatiiv on kohalik WebSocket.

Zoop Desktop Server töötab nagu kohalik teenus ja esitab WebSocket Sinu Rakendus jaoks. Teie eesmärk on endiselt TEF püümine. Akrediteerimine, konto, webhooks ja tehingute voog jääb platvormidele 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>"
}

Sinu Rakendus võtab jätkuvalt IOPAY sündmusi vastu.

TEF lisamine ei muuda asinkroonilise integreerimise lepingu: Sinu Rakendus saab IOPAY poolt iga sündmuse ja tehingu webhooks vastavalt lepingulisele integreerimisele. SDK/Serveri kohalik tagasisaatmine täiendab PDV kogemust; see ei kõrvalda IOPAY sündmuste laagrit.

Rekommendatud korrelatsiooni mudel

Harjutage puudusi enne kinnitamist.

Ära kinnita ainult heakskiitmise stsenaariumi. Õppejõud peab arvestama sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõiduki sõ

Aktiveerimisandmed peavad jääma väljapoole kasutajaliidma ja logid.

marketplace, seller ja accessKey on osa seadme tehnilist algustamist. Sinu Rakendus peab neid kaitsma ja kasutama automaatselt pärast aktiveerimist.

Kontrolliga enne kui piloot vabastatakse.

ametlik rakendamise dokumentatsioon.

Kasutage allpool olevaid juhiseid projekti paigaldatud komponendi versiooni tehnilise viitega. Parameetrid, koostalitlus, versioonid ja protokollid võivad muutuda; kinnita alati ametlikku dokumente rakendamise ajal.