Zum Hauptinhalt springen

Hobex

Integration mit Hobex – Zahlungen einfach und sicher abwickeln

Verfasst von Sophie Notdurfter

Einleitung - Warum Hobex anbinden?

Mit der Integration zu Hobex ermöglichst du deinen Gästen eine schnelle, sichere und unkomplizierte Bezahlung direkt über deine Guestnet-Plattform. Egal ob Online-Checkout oder beim Buchen von Zusatzleistungen – Zahlungen werden direkt abgewickelt, vollständig integriert und transparent dokumentiert.

Funktionsübersicht

  • Bezahlung von Gebühren beim Wochenprogramm

  • Online-Checkout: Gäste können am Ende ihres Aufenthaltes ihre Rechnung digital begleichen und auschecken – ganz ohne Warteschlange

  • Automatische Zahlungszuordnung: Zahlungen werden über Hobex verarbeitet und in dein PMS übertragen

  • Sichere Zahlungsabwicklung: PCI DSS konform, 3D Secure 2, DSGVO-konforme Verarbeitung
    ​​

So richtest du die Integration ein

  1. Stelle sicher, dass du über ein aktives Hobex Händlerkonto verfügst

  2. Prüfe, ob dein Vertrag die Online-Payment-Funktionalität (E-Commerce-Schnittstelle) beinhaltet

  3. Lege in ASA oder Protel Air, Hobex als Zahlungsart an und hinterlege den Kode "HOBEX".

Screenshot aus ASA:

ℹ️ Die Anbindung von Hobex kannst du in Guestnet direkt selbst durchführen. Eine ausführliche Anleitung findest du in unserem Artikel zur Integration.

Anbei findest du eine Übersicht der Vorraussetzungen die zur Anbindung in Guestnet notwendig sind.

Voraussetzungen für die Anbindung:

  • Die API-Zugangsdaten (EntityID und AccessToken) bereitgestellt durch Hobex
    ​

Apple Pay und Google Pay aktivieren

Neben klassischen Kartenzahlungen können über Hobex auch Apple Pay und Google Pay angebunden werden. Dafür sind zusätzliche Freischaltungen und Einstellungen notwendig.

Google Pay

Für die Nutzung von Google Pay muss zuerst ein Händlerkonto in der Google Pay and Wallet Console eingerichtet werden.

Voraussetzungen

Für die Aktivierung wird benötigt:

  • ein vollständiges Unternehmensprofil in der Google Pay and Wallet Console

  • eine hinterlegte Website/Webshop-URL

  • Freigabe der Website für Google Pay

  • Google Merchant ID

  • technische Aktivierung in der Hobex COPYandPAY Integration

Einrichtung

  1. Öffne die Google Pay and Wallet Console.

  2. Vervollständige dort das Unternehmensprofil.

  3. Gehe anschließend zu Google Pay API.

  4. Füge die Website hinzu, über welche Google Pay verwendet werden soll (ihre Guestnet URL).

  5. Wähle beim Integrationstyp Gateway aus.

  6. Lade die von Google geforderten Screenshots des Check-out-Prozesses hoch.

  7. Reiche den Antrag bei Google ein.

Hinweis zu den Screenshots

Für die Freigabe werden Screenshots des Zahlungsablaufs benötigt. Falls Google Pay noch nicht produktiv aktiv ist, kann der Ablauf über das Testsystem geprüft werden. Dadurch können Screenshots mit sichtbarem Google-Pay-Button erstellt werden.

Technische Aktivierung

Sobald Google Pay freigegeben wurde, muss Google Pay in der COPYandPAY Integration von Hobex aktiviert werden.

Dafür muss beim Parameter data-brands zusätzlich folgender Wert ergänzt werden:

GOOGLEPAY

Zusätzlich werden bei jeder Transaktion folgende Werte benötigt:

gatewayMerchantId = Entity ID, mit der COPYandPAY aufgerufen wird merchantId = Google Händler-ID / Google Merchant ID

Die Google Merchant ID findest du in der Google Pay and Wallet Console.

Zur Anleitung mit Screenshots

Apple Pay

Für Apple Pay muss die verwendete Guestnet-Domain bei Apple registriert werden. Dafür wird der folgende Domain-Verifizierungcode benötigt.

7B227073704964223A2238443436363842433735423143333743464432393034353242324446324241353536463136343832364537423434314143374633393539423546393831433743222C2276657273696F6E223A312C22637265617465644F6E223A313731353230333733383132362C227369676E6174757265223A223330383030363039326138363438383666373064303130373032613038303330383030323031303133313064333030623036303936303836343830313635303330343032303133303830303630393261383634383836663730643031303730313030303061303830333038323033653333303832303338386130303330323031303230323038313636333463386230653330353731373330306130363038326138363438636533643034303330323330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333031653137306433323334333033343332333933313337333433373332333735613137306433323339333033343332333833313337333433373332333635613330356633313235333032333036303335353034303330633163363536333633326437333664373032643632373236663662363537323264373336393637366535663535343333343264353035323466343433313134333031323036303335353034306230633062363934663533323035333739373337343635366437333331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333035393330313330363037326138363438636533643032303130363038326138363438636533643033303130373033343230303034633231353737656465626436633762323231386636386464373039306131323138646337623062643666326332383364383436303935643934616634613534313162383334323065643831316633343037653833333331663163353463336637656233323230643662616435643465666634393238393839336537633066313361333832303231313330383230323064333030633036303335353164313330313031666630343032333030303330316630363033353531643233303431383330313638303134323366323439633434663933653465663237653663346636323836633366613262626664326534623330343530363038326230363031303530353037303130313034333933303337333033353036303832623036303130353035303733303031383632393638373437343730336132663266366636333733373032653631373037303663363532653633366636643266366636333733373033303334326436313730373036633635363136393633363133333330333233303832303131643036303335353164323030343832303131343330383230313130333038323031306330363039326138363438383666373633363430353031333038316665333038316333303630383262303630313035303530373032303233303831623630633831623335323635366336393631366536333635323036663665323037343638363937333230363336353732373436393636363936333631373436353230363237393230363136653739323037303631373237343739323036313733373337353664363537333230363136333633363537303734363136653633363532303666363632303734363836353230373436383635366532303631373037303663363936333631363236633635323037333734363136653634363137323634323037343635373236643733323036313665363432303633366636653634363937343639366636653733323036663636323037353733363532633230363336353732373436393636363936333631373436353230373036663663363936333739323036313665363432303633363537323734363936363639363336313734363936663665323037303732363136333734363936333635323037333734363137343635366436353665373437333265333033363036303832623036303130353035303730323031313632613638373437343730336132663266373737373737326536313730373036633635326536333666366432663633363537323734363936363639363336313734363536313735373436383666373236393734373932663330333430363033353531643166303432643330326233303239613032376130323538363233363837343734373033613266326636333732366332653631373037303663363532653633366636643266363137303730366336353631363936333631333332653633373236633330316430363033353531643065303431363034313439343537646236666435373438313836383938393736326637653537383530376537396235383234333030653036303335353164306630313031666630343034303330323037383033303066303630393261383634383836663736333634303631643034303230353030333030613036303832613836343863653364303430333032303334393030333034363032323130306336663032336362323631346262333033383838613136323938336531613933663130353666353066613738636462396261346361323431636331346532356530323231303062653363643064666431363234376636343934343735333830653964343463323238613130383930613361316463373234623862346362383838393831386263333038323032656533303832303237356130303330323031303230323038343936643266626633613938646139373330306130363038326138363438636533643034303330323330363733313162333031393036303335353034303330633132343137303730366336353230353236663666373432303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330316531373064333133343330333533303336333233333334333633333330356131373064333233393330333533303336333233333334333633333330356133303761333132653330326330363033353530343033306332353431373037303663363532303431373037303663363936333631373436393666366532303439366537343635363737323631373436393666366532303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330353933303133303630373261383634386365336430323031303630383261383634386365336430333031303730333432303030346630313731313834313964373634383564353161356532353831303737366538383061326566646537626165346465303864666334623933653133333536643536363562333561653232643039373736306432323465376262613038666437363137636538386362373662623636373062656338653832393834666635343435613338316637333038316634333034363036303832623036303130353035303730313031303433613330333833303336303630383262303630313035303530373330303138363261363837343734373033613266326636663633373337303265363137303730366336353265363336663664326636663633373337303330333432643631373037303663363537323666366637343633363136373333333031643036303335353164306530343136303431343233663234396334346639336534656632376536633466363238366333666132626266643265346233303066303630333535316431333031303166663034303533303033303130316666333031663036303335353164323330343138333031363830313462626230646561313538333338383961613438613939646562656264656261666461636232346162333033373036303335353164316630343330333032653330326361303261613032383836323636383734373437303361326632663633373236633265363137303730366336353265363336663664326636313730373036633635373236663666373436333631363733333265363337323663333030653036303335353164306630313031666630343034303330323031303633303130303630613261383634383836663736333634303630323065303430323035303033303061303630383261383634386365336430343033303230333637303033303634303233303361636637323833353131363939623138366662333563333536636136326266663431376564643930663735346461323865626566313963383135653432623738396638393866373962353939663938643534313064386639646539633266653032333033323264643534343231623061333035373736633564663333383362393036376664313737633263323136643936346663363732363938323132366635346638376137643162393963623962303938393231363130363939306630393932316430303030333138323031383833303832303138343032303130313330383138363330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533303230383136363334633862306533303537313733303062303630393630383634383031363530333034303230316130383139333330313830363039326138363438383666373064303130393033333130623036303932613836343838366637306430313037303133303163303630393261383634383836663730643031303930353331306631373064333233343330333533303338333233313332333833353338356133303238303630393261383634383836663730643031303933343331316233303139333030623036303936303836343830313635303330343032303161313061303630383261383634386365336430343033303233303266303630393261383634383836663730643031303930343331323230343230633034366434346532613865643337643864646631623537393434663038653662386462323739316166666262316532336462383835323064363965316535343330306130363038326138363438636533643034303330323034343733303435303232303562363330383463636565353162633061386332626330623266373062383561393135633634313735323964653834653135383133343736346439323864613530323231303039663537626433316665373139306339373061613264313461376338643037666663376533613962313963353235353065663634643864616132373634396632303030303030303030303030227D

Voraussetzungen

Für die Aktivierung wird benötigt:

  • Zugang zur Hobex Open Payment Platform

  • Guestnet-Domain des Kunden, z. B. kunde.guest.net

  • Apple Domain Verification File

  • Merchant ID / Entity ID

  • Registrierung der Domain

  • technische Aktivierung in der COPYandPAY Integration

Einrichtung

  1. Öffne die Hobex Open Payment Platform.

  2. Wähle den entsprechenden Merchant in der Entity-Struktur aus.

  3. Gehe zu Administration > Mobile Payment.

  4. Öffne den Bereich Apple Pay Web Merchant Registration.

  5. Klicke auf Check registration status.

Für die Domain-Verifizierung muss als nächstes der vorhin angeführte Domain-Verifizierungcode im folgenden Pfad der verwendeten Domain abgelegt werden: 

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

Beispiel:

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

Sobald die Datei dort erreichbar ist, muss die entsprechende Domain zur Registrierung an Hobex weitergegeben werden. Nach erfolgreicher Registrierung kann Apple Pay technisch aktiviert werden.

Technische Aktivierung

Nach erfolgreicher Registrierung der Domain muss Apple Pay in der COPYandPAY Integration aktiviert werden.

Dafür muss beim Parameter data-brands zusätzlich folgender Wert ergänzt werden:

APPLEPAY

Zusätzlich sollte folgende CSS-Regel eingefügt werden, um mögliche Konflikte mit übergeordneten CSS-Klassen zu vermeiden:

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

Hinweis zur Open Payment Platform

Falls der Zugang zur Hobex Open Payment Platform nicht auffindbar ist, sollte der Einstieg bzw. der Zugang direkt bei Hobex angefragt werden.

Support

Hobex ist eine externe Schnittstelle zu Guestnet. Die Einbindung in Guestnet ist kostenfrei – es entstehen keine zusätzlichen Gebühren seitens Guestnet. Bitte beachte, dass gegebenenfalls Kosten durch Hobex selbst anfallen können.
Unser Customer Success Team berät dich gerne zur optimalen Einbindung:
📩 [email protected]

Hat dies deine Frage beantwortet?