Tengdu greiðslugáttina þína

Leiðbeiningar skref fyrir skref til að tengja þína eigin kortagreiðslugátt við Sóley. Finndu greiðslugáttina þína hér að neðan.

Uppsetningin felst í að líma inn lyklana hér að neðan. Hvernig Sóley fær að vita að greiðsla hafi farið í gegn fer eftir greiðslugáttinni: Teya SecurePay lætur Sóley sjálft vita, fyrir Teya netgreiðslur skráirðu einn vefkrók (webhook) í Business Portal Teya og Sóley spyr líka Teya þegar einhver athugar bókunina (sjá kaflann um þær), Sóley spyr Rapyd þegar einhver athugar bókunina og fyrir Straumur skráirðu eina bakslóð í Straumur-stjórnborðinu (sjá kaflann um Straumur). Ef Sóley getur ekki tengt greiðslu við bókun eða staðfest hana fær teymið okkar tilkynningu. Greiðsla er aldrei merkt greidd nema hún sé staðfest.
Þú ert áfram söluaðili (merchant of record). Ferðamenn greiða þér beint í gegnum þína eigin greiðslugátt; Sóley tekur aldrei við fjármununum þínum og reikningsfærir 10% þóknun sína sérstaklega.

Teya SecurePay (fyrir fyrirtæki með SecurePay-aðgang)

SecurePay er eldri greiðslusíða Teya (áður Borgun). Tengdu hana ef Teya hefur þegar sett upp SecurePay fyrir fyrirtækið þitt. Teya segir að brátt verði hætt að taka inn nýja söluaðila og að hún loki í byrjun árs 2027. Fyrir nýjar netgreiðslur Teya skaltu nota kaflann um Teya netgreiðslur. Ef þú ert ekki viss hvort þú ert með skaltu senda póst á support@soley.travel.

Skref

  1. 1Þú ert með SecurePay ef viðskiptavinir á vefsíðunni þinni eru sendir á greiðslusíðu Teya eða Borgunar (slóðin inniheldur securepay.borgun.is).
  2. 2Teya gaf út söluaðilanúmerið, greiðslugáttarnúmerið og leynilykilinn þegar síðan var sett upp. Sá sem setti upp vefsíðuna þína gæti verið með þau í greiðslustillingum hennar.
  3. 3Ef þú finnur þau ekki skaltu biðja Teya um SecurePay-söluaðilanúmerið, greiðslugáttarnúmerið og leynilykilinn á hjalp@teya.is eða í síma 560 1600. Þau eru ekki búin til í vefþjónustu Teya.
  4. 4Notaðu ekki Client ID og Client Secret úr Business Portal Teya (Stillingar, Samþættingar). Þau eru fyrir nýja greiðslukerfi Teya og virka ekki hér.
  5. 5Afritaðu gildin þrjú inn í Sóley nákvæmlega eins og þau eru, án aukabila. Sendu þau aldrei í tölvupósti, ekki heldur til Sóleyjar.
  6. 6Vistaðu. Sóley stillir umhverfið: raunumhverfi á soley.travel, svo þetta eru raungildin þín. Vistun athugar aðeins að gildin hafi rétt snið. Hún hefur ekki samband við Teya, svo rangur leynilykill kemur aðeins í ljós þegar fyrsta greiðslan misheppnast.

Hvað á að líma inn

Merchant ID
Tala sem Teya gefur út með SecurePay-greiðslusíðunni þinni.
Payment gateway ID
Teya gefur það út með sömu SecurePay-uppsetningu. Hvert par söluaðilanúmers og greiðslugáttarnúmers virkar í einum gjaldmiðli.
SecurePay secret key
Teya gefur hann út með SecurePay-uppsetningunni. Meðhöndlaðu hann eins og lykilorð: deildu honum aldrei og sendu hann aldrei í tölvupósti.

Teya netgreiðslur (Teya online payments)

Ný netgreiðslulausn Teya (Hosted Checkout). Tengdu hana ef netverslunin þín hjá Teya er með netgreiðsluáskrift Teya. Sóley býr til greiðslusíðu hjá Teya fyrir hverja greiðslu og Teya lætur Sóley vita þegar greiðsla tekst, með vefkrók (webhook) sem þú skráir í Business Portal Teya.

Skref

  1. 1Skráðu þig inn á Business Portal Teya (business.teya.com) með Teya ID og opnaðu Stillingar (Settings) og síðan netverslunina þína. Verslun fyrir posa tekur ekki við netgreiðslum: netverslunin er sérstök verslun undir sama Teya-aðgangi.
  2. 2Opnaðu Samþættingar (Integrations) og búðu til API-aðgangsupplýsingar fyrir netverslun. Teya sýnir Client ID, Client Secret og Store ID. Client Secret er aðeins sýndur einu sinni, svo afritaðu hann þá. Ef vefgáttin segir að engin samhæf verslun hafi fundist vantar netgreiðsluáskrift á verslunina: biddu tengilið þinn hjá Teya um að bæta henni við.
  3. 3Áfram í Samþættingum, veldu Add webhook og settu inn bakslóðina sem Sóley sýnir í reitnum „Skráðu þessa bakslóð“ á greiðsluþrepinu. Vefgáttin gefur þá út opinberan lykil fyrir vefkrókinn.
  4. 4Límdu Client ID, Client Secret, Store ID og opinbera lykil vefkróksins inn í Sóley. Sendu þau aldrei í tölvupósti, ekki heldur til Sóleyjar.
  5. 5Vistaðu. Sóley stillir umhverfið: raunumhverfi á soley.travel, svo notaðu aðgangsupplýsingarnar og vefkrókinn frá business.teya.com. Prófunarvefgátt Teya (business.teya.xyz) er fyrir prófunarvef Sóleyjar og lyklar blandast aldrei á milli. Vistun biður Teya um aðgangslykil (access token) með Client ID og Client Secret og athugar snið Store ID og opinbera lykilsins. Aðeins greiðsla sannar Store ID og lykil vefkróksins.

Hvað á að líma inn

Client ID
Business Portal Teya, Stillingar, netverslunin þín, Samþættingar. Sýnt þegar þú býrð til API-aðgangsupplýsingarnar.
Client Secret
Sýndur einu sinni þegar þú býrð til aðgangsupplýsingarnar. Afritaðu hann þá.
Store ID
Sýnt með Client ID og Client Secret.
Opinber lykill vefkróks
Vefgáttin gefur hann út þegar þú bætir við vefkróknum (Samþættingar, Add webhook). Einn lykill fyrir hvern vefkrók og hvert umhverfi.
Bakslóð (þú skráir hana)
Samþættingar, Add webhook: límdu slóðina úr „Skráðu þessa bakslóð“ reitnum í Sóley.

Straumur (Kvika)

Straumur (Kvika) hefur nokkur aukaskref: auk API-lykils og auðkennis útstöðvar afritarðu undirritunarleyndarmál og skráir eina bakslóð svo Sóley frétti þegar greiðslu lýkur. Það tekur nokkrar mínútur: fylgdu skrefunum hér að neðan. Samningurinn þinn við Straumur þarf að ná yfir Payment Link-útstöð. Ef útstöðin þín var aðeins sett upp fyrir Components misheppnast greiðslur (villa 2016) þar til Straumur bætir við Payment Link-útstöð.

Skref

  1. 1Skráðu þig inn á Straumur-stjórnborðið á portal.straumur.is.
  2. 2Farðu í Settings → API keys og afritaðu leyndar-API-lykilinn (ekki opinbera lykilinn). Límdu hann í 'API key' reitinn í Sóley.
  3. 3Farðu í Terminals (Útstöðvar), opnaðu Payment Link-útstöðina þína og afritaðu 12 stafa Auðkenni útstöðvar. Þetta er ekki 8 stafa útstöðvarnúmerið. Límdu það í 'Terminal identifier'. Ef þú ert ekki með Payment Link-útstöð skaltu biðja Straumur um að bæta einni við.
  4. 4Farðu í Webhooks / Notifications og afritaðu undirritunarleyndarmálið (langur hex-strengur). Ef ekkert er til, búðu það til. Límdu það í 'Webhook HMAC secret'.
  5. 5Áfram undir Webhooks / Notifications, bættu við tilkynningu/webhook og límdu bakslóðina sem Sóley sýnir þér í 'Skráðu þessa bakslóð' reitnum á greiðsluþrepinu. Vistaðu hana í Straumur-stjórnborðinu.
  6. 6Til baka í Sóley, vistaðu. Sóley stillir umhverfið: á soley.travel er það raunumhverfi, svo límdu inn raunlyklana og skráðu bakslóðina sem Sóley sýnir þér þar. Vistun athugar aðeins snið gildanna og hefur ekki samband við Straumur, svo rangur lykill eða leynilykill kemur aðeins í ljós þegar fyrsta greiðslan misheppnast.

Hvað á að líma inn

API key
Settings → API keys. Leyndarlykillinn, ekki opinberi lykillinn.
Terminal identifier
Terminals, Payment Link-útstöð. Nákvæmlega 12 stafir.
Webhook HMAC secret
Webhooks / Notifications → undirritunarleyndarmál. Langur hex-strengur.
Bakslóð (þú skráir hana)
Webhooks / Notifications → bættu við tilkynningu → límdu slóðina úr 'Skráðu þessa bakslóð' reitnum í Sóley.

Rapyd / Valitor / Korta

Rapyd (sem knýr einnig Valitor og Korta) notar aðgangslykil (access key) og leyndarlykil (secret key) úr Rapyd Client Portal.

Skref

  1. 1Skráðu þig inn á Rapyd Client Portal.
  2. 2Opnaðu Developers → Credentials.
  3. 3Afritaðu aðgangslykilinn (Access key).
  4. 4Afritaðu leyndarlykilinn (Secret key). Mikilvægt: Rapyd sýnir leyndarlykilinn aðeins einu sinni, við stofnun. Ef þú hefur týnt honum, búðu til nýtt lyklapar.
  5. 5Sandbox- og Production-lyklar eru ólíkir lyklar í stjórnborðinu. Á soley.travel skaltu nota Production-lyklana.
  6. 6Vistaðu. Vistun sendir Rapyd undirritaða beiðni og síðan segir að Rapyd hafi tekið við lyklunum aðeins ef svo var.

Hvað á að líma inn

Access key
Developers → Credentials → Access key.
Secret key
Sýndur við hlið aðgangslykilsins. Sýnilegur aðeins einu sinni, við stofnun.

Raunlyklar og ein lítil raungreiðsla

Sóley stillir umhverfið og sýnir það í greiðslustillingunum: raunumhverfi á soley.travel, svo hver lykill sem þú límir þar er raunlykill og tekur við raunverulegum kortagreiðslum. Þú skiptir aldrei um umhverfi. Prófunarlyklar (Sandbox) greiðslugáttarinnar eru aðeins fyrir prófunarvef Sóleyjar, svo notaðu þá ekki hér.

  1. 1Límdu inn raunlyklana og vistaðu.
  2. 2Raunprófið er ein lítil raunveruleg bókun. Athugaðu í vefgátt greiðslugáttarinnar að peningarnir hafi borist. Þar til greiðsla hefur farið í gegnum lyklana segir greiðslustillingin að greiðslugáttin hafi ekki staðfest greiðslu enn. Eftir það segir hún „Staðfest með greiðslu“ ásamt dagsetningu.

Hvernig veit ég að það virkaði?

Þegar þú hefur vistað segja greiðslustillingarnar hvað var athugað og lesa það eins í hvert sinn sem þú opnar þær:

  • •Lyklar vistaðir og sniðið athugað: gildin hafa rétt snið. Sóley hefur ekki haft samband við greiðslugáttina þína, svo rangur leynilykill kemur aðeins í ljós við fyrstu greiðslu. Þetta sýna Teya SecurePay og Straumur. Teya netgreiðslur sýna það líka, en vistun biður Teya um aðgangslykil (access token), svo rangt Client ID eða Client Secret er hafnað þegar þú vistar; aðeins greiðsla sannar Store ID og opinbera lykil vefkróksins.
  • •Rapyd tók við þessum lyklum: Sóley sendi Rapyd undirritaða beiðni og Rapyd tók við henni. Það sannar samt ekki að greiðsla virki.
  • •Staðfest með greiðslu þann tiltekna dag (grænt): raunveruleg greiðsla hefur farið í gegnum þessa lykla. Þetta er eina sönnunin.
  • •Ekki tilbúið (gult): stöðulínan segir með orðum hvers vegna, til dæmis að lykil vanti eða gildi hafi rangt snið. Hún merkir engan reit. Lagaðu það og vistaðu aftur. Reitur sem stillingarnar merkja rauðan er reitur sem þær vista ekki eins og hann var sleginn inn: gildi vantar, það hefur rangt snið eða greiðslugáttin þín hafnaði lyklinum.

Greiðsluþrepið undir „Hvað er eftir áður en bókanir opnast“ er klárt þegar lyklarnir standast athugunina. Ef fyrirtækið þitt er þegar opið fyrir bókunum fer það úr leit ferðamanna þegar þú vistar nýja lykla, þar til þeir standast athugunina, og staðfesting greiðslu byrjar upp á nýtt.

Endurgreiðslur

Sóley flytur ekki peninga og sendir engar endurgreiðslur til greiðslugáttarinnar þinnar. Þegar bókun er afbókuð og endurgreiða þarf gestinn endurgreiðir þú á kort gestsins í vefgátt þinnar eigin greiðslugáttar, eins og þú gerir fyrir bókanir á þinni eigin vefsíðu. Sóley skráir endurgreiðsluna sem útistandandi og sýnir „Bíður endurgreiðslu“ á bókuninni. Bókunin birtist sem endurgreidd þegar teymið okkar hefur staðfest að þú hafir endurgreitt.

Teya netgreiðslur
Business Portal Teya.
Teya SecurePay
B-Online, vefgátt Teya fyrir SecurePay-greiðslur.
Straumur
Straumur-stjórnborðið.
Rapyd / Valitor / Korta
Rapyd Client Portal.

Sóley sýnir upphæðina sem á að endurgreiða og hvar. Ef ekki er hægt að endurgreiða í vefgáttinni skaltu senda póst á support@soley.travel.

Bilanaleit

Reitur er merktur sem rangur.

Afritaðu hvert gildi án bila fremst eða aftast. Leyndarmál eru há- og lágstafanæm. Gakktu úr skugga um að þú hafir afritað leyndarlykilinn, ekki opinbera/aðgangslykilinn.

Lyklarnir virka í prófunarumhverfi greiðslugáttarinnar en ekki hér.

Prófunar- og raunumhverfi nota ólíka lykla. Á soley.travel notar Sóley raunumhverfi, svo límdu inn raunlyklana frá greiðslugáttinni.

Greiðslan staðfestist ekki eftir að ferðamaðurinn greiddi.

Það fer eftir greiðslugáttinni. Teya SecurePay og Straumur láta Sóley vita með bakslóð, svo fyrir Straumur skaltu athuga hvort bakslóðin sé skráð og undirritunarleyndarmálið rétt. Fyrir Teya netgreiðslur skaltu athuga hvort vefkrókurinn í Business Portal Teya sé með slóðina sem Sóley sýnir og hvort þú límdir inn opinbera lykil hans; Sóley spyr líka Teya þegar bókunarsíðan er opnuð. Sóley spyr Rapyd þegar bókunarsíðan er opnuð eða aðstoðarmaður athugar bókunina, svo opnaðu bókunarsíðuna aftur. Athugaðu í öllum tilvikum hvort lyklarnir séu raunlyklarnir (Production). Ef Sóley getur ekki tengt greiðslu við bókun eða staðfest hana fær teymið okkar tilkynningu og getur staðfest hana eftir að hafa skoðað vefgátt greiðslugáttarinnar þinnar. Sendu póst á support@soley.travel með bókunarnúmerinu.

Ég týndi Rapyd leyndarlyklinum.

Rapyd sýnir hann aðeins einu sinni. Búðu til nýtt lyklapar í Developers → Credentials og límdu nýju Access + Secret lyklana.

Ég finn lyklana mína alls ekki.

Hafðu samband við þjónustu greiðslugáttarinnar þinnar (Teya, Straumur, Rapyd/Valitor) og biddu um netgreiðsluaðganginn þinn. Þú getur líka sent póst á support@soley.travel og við hjálpum.

Enn í vandræðum? Sendu póst á support@soley.travel og við aðstoðum þig skref fyrir skref.