Integroi TEF.

Oma toimintasi paikan päällä
IOPAYn tehostamana

Hyvin määritelty kaksitasoinen integraatio

TEF-henkilön vangitseminen tapahtuu paikallisesti välillä Oma SovelluksesiZoop-komponentti ja PINPAD-maksutapahtuma on kuitenkin edelleen integroitu IOPAY-maksutapahtumaan. Näin säilytetään yksi kerros tiliä, tapahtumahallintaa, pääteaktivaatiota, tapahtumia ja webhooks-ohjelmaa varten

Kuka tekee mitäkin kotoutumisessa

Alla oleva erottaminen estää Zoop-komponentin käytön paikallisessa kaappauksessa, eikä se sekoita toiminnan pääintegraation vaihtoon.

SDK Upotettu tai työpöytäpalvelin

Paikallisen kerroksen käyttöön on kaksi dokumentoitua tapaa säilyttää sama IOPAY-arkkitehtuuri tiliä, aktivointia ja tapahtumia varten

Tyhjästä hankkeesta ensimmäiseen maksuun viidessä vaiheessa

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 integroitu suoraan PDV:hen

Tässä lähestymistavassa kaappausosa on Oma Sovelluksesi:ssa Liitännäinen keskustelee paikallisesti PINPAD:n kanssa, kun operaatio on edelleen yhteydessä IOPAY-infrastruktuuriin.

Aktivoinnin jälkeinen aloittaminen

Sen jälkeen marketplace, seller ja accessKey Jos ne on saatu takaisin ja säilytetty, käytä näitä arvoja aika-ajossa SDK-järjestelmän käynnistämiseksi uudelleen.

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

val desktopPlugin = DesktopPlugin(
    Zoop.constructorParameters()
)

Zoop.plug(desktopPlugin)

Kotouttamisen tila

Tokentti on syntynyt SDK:ssa ja linkki on valmistunut IOPAY:ssa

Aktivointi kytkee laitteen oikeaan tiliin Tämä vaihe on tehtävä ennen ensimmäistä tapahtumaa ja testattava myös sen jälkeen, kun käynnistät sovelluksesi uudelleen

Kysy tapahtuma-avainta ennen veloittamista

Zoop-tapahtuma-avaimen on oltava PINPADissa, jotta korttimaksut voidaan suorittaa Jos olet poissa, napauta IOPAY-näppäintä, jotta korjaus voidaan koordinoida laitetoimittajan kanssa.

Esimerkki korttimaksusta

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)

Käsittele myös virtauksen väliviestejä näyttääksesi operaattorille ohjeita, kuten lähestymistä, syöttämistä tai kortin lukemista Paikallisen palautteen avulla PDV voi seurata, mitä terminaalissa tapahtuu

Mikä jatkuu tuloksessa

Vaihtoehto paikallisen WebSocket-palvelun kautta

Zoop Desktop Server toimii paikallisena palveluna ja paljastaa WebSocketin Oma Sovelluksesi:lle. Spektiivisi on edelleen TEF:n kaappaus Akkreditointi-, tili-, webhooks- ja tapahtumavirta IOPAY-alustoille.

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

Oma Sovelluksesi vastaanottaa edelleen IOPAYn tapahtumia.

Lisää TEF ei muuta epäyhtenäistä integraatiosopimusta: Oma Sovelluksesi edelleen vastaanotetaan webhooks mistä IOPAY Kunkin tapahtuman ja liiketoimen osalta sopimuksen mukaisen integraation mukaan SDK/Server Local Return täydentää PDV-kokemusta; se ei poista IOPAY Tapahtumakerros

Suositeltu vastaavuusmalli

Harjoitusviat ennen hyväksyntää

Älä vain hyväksy hyväksymisskenaariota Lentäjän on harkittava viestintähäiriöitä, vanhentunutta kuittia, keskeytystä kiinnioton aikana, uudelleenkäynnistettävä sovellus ja peruutukset

Aktivointitietojen on pysyttävä rajapinnan ja lokien ulkopuolella

Market, seller ja AccessKey ovat osa laitteen teknistä käynnistystä. Oma Sovelluksesi:n on suojattava ja käytettävä sitä automaattisesti aktivaation jälkeen.

Tarkistuslista ennen lentäjän julkaisua

Viralliset asiakirjat täytäntöönpanoa varten

Käytä alla olevia oppaita teknisenä viitetietona projektin Parametreihin asennetun komponentin versiolle, yhteensopivuudelle, versioille ja protokollille voi kehittyä; vahvista aina viralliset asiakirjat toteutuksen aikana