Vai al contenuto principale

Hobex

Integrazione con Hobex – Elaborare i pagamenti in modo semplice e sicuro

Scritto da Sophie Notdurfter

Introduzione – Perché collegare Hobex?

Con l’integrazione di Hobex offri ai tuoi ospiti la possibilità di effettuare pagamenti rapidi, sicuri e senza complicazioni direttamente tramite la tua piattaforma Guestnet. Che si tratti del check-out online o della prenotazione di servizi aggiuntivi, i pagamenti vengono elaborati in modo immediato, completamente integrato e documentato in maniera trasparente.

Panoramica delle funzionalità

  • Pagamento delle quote per il programma settimanale

  • Check-out online: gli ospiti possono saldare digitalmente il conto al termine del soggiorno ed effettuare il check-out, senza fare la fila.

  • Riconciliazione automatica dei pagamenti: i pagamenti vengono elaborati tramite Hobex e trasferiti nel tuo PMS.

  • Elaborazione sicura dei pagamenti: conforme a PCI DSS, 3D Secure 2, elaborazione conforme al GDPR.
    ​

Come configurare l’integrazione

  1. Assicurati di avere un account commerciante Hobex attivo.

  2. Verifica che il tuo contratto includa la funzionalità di pagamento online (interfaccia e-commerce).

  3. Imposta Hobex come metodo di pagamento in ASA o Protel Air, e inserisci il codice "HOBEX".

Screenshot da ASA:

ℹ️ Puoi collegare Hobex a Guestnet direttamente tu stesso. Una guida dettagliata è disponibile nel nostro articolo dedicato all’integrazione.

In allegato trovi una panoramica dei requisiti necessari per l’integrazione.

Requisiti per l’integrazione:

Tue credenziali API di Hobex (EntityID e AccessToken), fornito da Hobex
​

Attivare Apple Pay e Google Pay

Oltre ai classici pagamenti con carta, tramite Hobex è possibile collegare anche Apple Pay e Google Pay. Per farlo sono necessarie ulteriori attivazioni e impostazioni.

Google Pay

Per utilizzare Google Pay è necessario creare prima un account commerciante nella Google Pay and Wallet Console.

Requisiti

Per l’attivazione sono necessari:

  • un profilo aziendale completo nella Google Pay and Wallet Console

  • un URL del sito web/webshop inserito

  • l’approvazione del sito web per Google Pay

  • Google Merchant ID

  • attivazione tecnica nell’integrazione Hobex COPYandPAY

Configurazione

  1. Apri la Google Pay and Wallet Console.

  2. Completa il profilo aziendale.

  3. Vai quindi su Google Pay API.

  4. Aggiungi il sito web tramite il quale deve essere utilizzato Google Pay, quindi il tuo URL Guestnet.

  5. Seleziona Gateway come tipo di integrazione.

  6. Carica gli screenshot del processo di check-out richiesti da Google.

  7. Invia la richiesta a Google.

Nota sugli screenshot

Per l’approvazione sono necessari screenshot del processo di pagamento. Se Google Pay non è ancora attivo in modalità produttiva, il processo può essere testato tramite il sistema di test. In questo modo è possibile creare screenshot con il pulsante Google Pay visibile.

Attivazione tecnica

Dopo l’approvazione di Google Pay, Google Pay deve essere attivato nell’integrazione Hobex COPYandPAY.

Per farlo, nel parametro data-brands deve essere aggiunto anche il seguente valore:

GOOGLEPAY

Inoltre, per ogni transazione sono necessari i seguenti valori:

gatewayMerchantId = Entity ID con cui viene richiamato COPYandPAY merchantId = Google Händler-ID / Google Merchant ID

La Google Merchant ID si trova nella Google Pay and Wallet Console.

Vai alla guida con screenshot.

Apple Pay

Per Apple Pay, il dominio Guestnet utilizzato deve essere registrato presso Apple. Per farlo è necessario il seguente codice di verifica del dominio.

7B227073704964223A2238443436363842433735423143333743464432393034353242324446324241353536463136343832364537423434314143374633393539423546393831433743222C2276657273696F6E223A312C22637265617465644F6E223A313731353230333733383132362C227369676E6174757265223A223330383030363039326138363438383666373064303130373032613038303330383030323031303133313064333030623036303936303836343830313635303330343032303133303830303630393261383634383836663730643031303730313030303061303830333038323033653333303832303338386130303330323031303230323038313636333463386230653330353731373330306130363038326138363438636533643034303330323330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333031653137306433323334333033343332333933313337333433373332333735613137306433323339333033343332333833313337333433373332333635613330356633313235333032333036303335353034303330633163363536333633326437333664373032643632373236663662363537323264373336393637366535663535343333343264353035323466343433313134333031323036303335353034306230633062363934663533323035333739373337343635366437333331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333035393330313330363037326138363438636533643032303130363038326138363438636533643033303130373033343230303034633231353737656465626436633762323231386636386464373039306131323138646337623062643666326332383364383436303935643934616634613534313162383334323065643831316633343037653833333331663163353463336637656233323230643662616435643465666634393238393839336537633066313361333832303231313330383230323064333030633036303335353164313330313031666630343032333030303330316630363033353531643233303431383330313638303134323366323439633434663933653465663237653663346636323836633366613262626664326534623330343530363038326230363031303530353037303130313034333933303337333033353036303832623036303130353035303733303031383632393638373437343730336132663266366636333733373032653631373037303663363532653633366636643266366636333733373033303334326436313730373036633635363136393633363133333330333233303832303131643036303335353164323030343832303131343330383230313130333038323031306330363039326138363438383666373633363430353031333038316665333038316333303630383262303630313035303530373032303233303831623630633831623335323635366336393631366536333635323036663665323037343638363937333230363336353732373436393636363936333631373436353230363237393230363136653739323037303631373237343739323036313733373337353664363537333230363136333633363537303734363136653633363532303666363632303734363836353230373436383635366532303631373037303663363936333631363236633635323037333734363136653634363137323634323037343635373236643733323036313665363432303633366636653634363937343639366636653733323036663636323037353733363532633230363336353732373436393636363936333631373436353230373036663663363936333739323036313665363432303633363537323734363936363639363336313734363936663665323037303732363136333734363936333635323037333734363137343635366436353665373437333265333033363036303832623036303130353035303730323031313632613638373437343730336132663266373737373737326536313730373036633635326536333666366432663633363537323734363936363639363336313734363536313735373436383666373236393734373932663330333430363033353531643166303432643330326233303239613032376130323538363233363837343734373033613266326636333732366332653631373037303663363532653633366636643266363137303730366336353631363936333631333332653633373236633330316430363033353531643065303431363034313439343537646236666435373438313836383938393736326637653537383530376537396235383234333030653036303335353164306630313031666630343034303330323037383033303066303630393261383634383836663736333634303631643034303230353030333030613036303832613836343863653364303430333032303334393030333034363032323130306336663032336362323631346262333033383838613136323938336531613933663130353666353066613738636462396261346361323431636331346532356530323231303062653363643064666431363234376636343934343735333830653964343463323238613130383930613361316463373234623862346362383838393831386263333038323032656533303832303237356130303330323031303230323038343936643266626633613938646139373330306130363038326138363438636533643034303330323330363733313162333031393036303335353034303330633132343137303730366336353230353236663666373432303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330316531373064333133343330333533303336333233333334333633333330356131373064333233393330333533303336333233333334333633333330356133303761333132653330326330363033353530343033306332353431373037303663363532303431373037303663363936333631373436393666366532303439366537343635363737323631373436393666366532303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330353933303133303630373261383634386365336430323031303630383261383634386365336430333031303730333432303030346630313731313834313964373634383564353161356532353831303737366538383061326566646537626165346465303864666334623933653133333536643536363562333561653232643039373736306432323465376262613038666437363137636538386362373662623636373062656338653832393834666635343435613338316637333038316634333034363036303832623036303130353035303730313031303433613330333833303336303630383262303630313035303530373330303138363261363837343734373033613266326636663633373337303265363137303730366336353265363336663664326636663633373337303330333432643631373037303663363537323666366637343633363136373333333031643036303335353164306530343136303431343233663234396334346639336534656632376536633466363238366333666132626266643265346233303066303630333535316431333031303166663034303533303033303130316666333031663036303335353164323330343138333031363830313462626230646561313538333338383961613438613939646562656264656261666461636232346162333033373036303335353164316630343330333032653330326361303261613032383836323636383734373437303361326632663633373236633265363137303730366336353265363336663664326636313730373036633635373236663666373436333631363733333265363337323663333030653036303335353164306630313031666630343034303330323031303633303130303630613261383634383836663736333634303630323065303430323035303033303061303630383261383634386365336430343033303230333637303033303634303233303361636637323833353131363939623138366662333563333536636136326266663431376564643930663735346461323865626566313963383135653432623738396638393866373962353939663938643534313064386639646539633266653032333033323264643534343231623061333035373736633564663333383362393036376664313737633263323136643936346663363732363938323132366635346638376137643162393963623962303938393231363130363939306630393932316430303030333138323031383833303832303138343032303130313330383138363330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533303230383136363334633862306533303537313733303062303630393630383634383031363530333034303230316130383139333330313830363039326138363438383666373064303130393033333130623036303932613836343838366637306430313037303133303163303630393261383634383836663730643031303930353331306631373064333233343330333533303338333233313332333833353338356133303238303630393261383634383836663730643031303933343331316233303139333030623036303936303836343830313635303330343032303161313061303630383261383634386365336430343033303233303266303630393261383634383836663730643031303930343331323230343230633034366434346532613865643337643864646631623537393434663038653662386462323739316166666262316532336462383835323064363965316535343330306130363038326138363438636533643034303330323034343733303435303232303562363330383463636565353162633061386332626330623266373062383561393135633634313735323964653834653135383133343736346439323864613530323231303039663537626433316665373139306339373061613264313461376338643037666663376533613962313963353235353065663634643864616132373634396632303030303030303030303030227D

Requisiti

Per l’attivazione sono necessari:

  • accesso alla Hobex Open Payment Platform

  • dominio Guestnet del cliente, ad esempio cliente.guest.net

  • Apple Domain Verification File

  • Merchant ID / Entity ID

  • registrazione del dominio

  • attivazione tecnica nell’integrazione COPYandPAY

Configurazione

  1. Apri la Hobex Open Payment Platform.

  2. Seleziona il merchant corrispondente nella struttura Entity.

  3. Vai su Administration > Mobile Payment.

  4. Apri l’area Apple Pay Web Merchant Registration.

  5. Clicca su Check registration status.

Per la verifica del dominio, il codice di verifica del dominio indicato sopra deve essere depositato nel seguente percorso del dominio utilizzato:

https://[DOMAIN_NAME]/.well-known/apple-developer-merchantid-domain-association

Esempio:

https://cliente.guest.net/.well-known/apple-developer-merchantid-domain-association

Non appena il file è raggiungibile in questo percorso, il dominio corrispondente deve essere inviato a Hobex per la registrazione. Dopo la registrazione riuscita, Apple Pay può essere attivato tecnicamente.

Attivazione tecnica

Dopo la registrazione riuscita del dominio, Apple Pay deve essere attivato nell’integrazione COPYandPAY.

Per farlo, nel parametro data-brands deve essere aggiunto anche il seguente valore:

APPLEPAY

Inoltre, dovrebbe essere inserita la seguente regola CSS per evitare possibili conflitti con classi CSS sovraordinate:

.wpwl-apple-pay-button {   -webkit-appearance: -apple-pay-button !important; }

Nota sulla Open Payment Platform

Se l’accesso alla Hobex Open Payment Platform non è disponibile o non è reperibile, l’accesso deve essere richiesto direttamente a Hobex.

Supporto

Hobex è un’interfaccia esterna a Guestnet. L’integrazione in Guestnet è gratuita: non sono previsti costi aggiuntivi da parte di Guestnet. Ti ricordiamo che potrebbero essere applicati eventuali costi da parte di Hobex.
Il nostro Customer Success Team è a tua disposizione per consigliarti sulla migliore implementazione:
📩 [email protected]

Hai ricevuto la risposta alla tua domanda?