sóley

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 — flestir nota Teya.

Engin tæknileg uppsetning: þegar lyklarnir þínir eru vistaðir staðfestir Sóley hverja greiðslu sjálfkrafa hjá greiðslugáttinni þinni. Uppsetningin felst aðeins í að líma inn lyklana hér að neðan.
Þú 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 / Borgun (SecurePay) — Mælt meðStraumur (Kvika)Rapyd / Valitor / Korta

Teya / Borgun (SecurePay)Mælt með

Teya (áður Borgun) er algengasta kortagreiðslugáttin hjá íslenskum rekstraraðilum. Þú tengir hana með upplýsingunum úr póstinum frá Teya/Borgun með SecurePay-aðgangsupplýsingunum — engin uppsetning í stjórnborði er nauðsynleg.

Skref

  1. 1Finndu SecurePay-póstinn sem Teya/Borgun sendi þegar aðgangurinn þinn var settur upp (efnislínan nefnir oftast 'SecurePay' eða 'Borgun').
  2. 2Ef þú finnur ekki póstinn, skráðu þig inn á Teya-vefþjónustuna á teya.com og opnaðu Settings → Merchant / Online payments.
  3. 3Afritaðu gildin þrjú hér að neðan nákvæmlega eins og þau birtast — engin aukabil.
  4. 4Hafðu umhverfið á Prófunarumhverfi (Sandbox), vistaðu og prófaðu. Skiptu yfir í Raunumhverfi þegar allt er tilbúið fyrir raunverulegar greiðslur.

Hvað á að líma inn

Merchant ID
Tölulegt söluaðilanúmer, efst í SecurePay-póstinum (einnig sýnt í Teya-vefþjónustunni).
Payment gateway ID
Stutt númer í sama pósti, oft merkt 'Gateway' eða 'Web payment gateway'.
SecurePay secret key
Leyndarlykillinn í SecurePay-póstinum. Meðhöndlaðu hann eins og lykilorð; deildu honum aldrei.

Straumur (Kvika)

Straumur (Kvika) er eina greiðslugáttin með nokkur aukaskref: auk API-lykils og kennimerkis posa afritarðu undirritunarleyndarmál og skráir eina bakslóð svo við fáum staðfestingu þegar greiðslu lýkur. Það tekur samt aðeins nokkrar mínútur — fylgdu skrefunum hér að neðan. (Flestir nota Teya og sleppa þessu öllu.)

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 og afritaðu 12 stafa kennimerki posans (sama auðkenni og prentað er á posann þinn). Límdu það í 'Terminal identifier'.
  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, hafðu umhverfið á Prófunarumhverfi og vistaðu. Gerðu eina prófunarbókun. Þegar hún staðfestist skaltu skipta yfir í Raunumhverfi, líma inn raunlyklana og skrá bakslóð raunumhverfisins á sama hátt.

Hvað á að líma inn

API key
Settings → API keys. Leyndarlykillinn, ekki opinberi lykillinn.
Terminal identifier
Terminals. 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. 5Notaðu Sandbox-lykla til að prófa og Production-lykla fyrir alvöru greiðslur — þetta eru ólíkir lyklar í stjórnborðinu.

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.

Prófunarumhverfi vs Raunumhverfi

Allar greiðslugáttir gefa þér tvö sett af lyklum. Prófunarlyklar (Sandbox) leyfa þér að keyra gervigreiðslur til að ganga úr skugga um að allt sé rétt tengt — engar raunverulegar greiðslur fara fram. Raunlyklar (Production) taka við raunverulegum kortagreiðslum.

  1. 1Byrjaðu í Prófunarumhverfi. Límdu prófunarlyklana og vistaðu.
  2. 2Gerðu prófunarbókun frá upphafi til enda til að staðfesta að greiðsluhlekkurinn opnist og greiðslunni ljúki.
  3. 3Þegar það virkar skaltu velja Raunumhverfi í fellivalmyndinni fyrir umhverfi og líma inn raunlyklana.
  4. 4Gerðu eina litla raunverulega bókun til að staðfesta að greiðslan berist á reikninginn þinn.

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

Eftir að þú vistar athugar Sóley lyklana hjá greiðslugáttinni þinni:

  • •Vistað og staðfest (grænt) — lyklarnir eru réttir og Sóley náði í greiðslugáttina. Uppsetningunni er lokið.
  • •Vistað, ekki tókst að staðfesta (gult) — lyklarnir eru geymdir en við náðum ekki í greiðslugáttina í augnablikinu (oft tímabundin netröskun). Athugaðu aftur síðar eða gerðu prófunarbókun.
  • •Villa (rautt) — lyklunum var hafnað. Afritaðu þá aftur vandlega og athugaðu hvort þú hafir ruglað saman Prófunar- og Raunlyklum.

Þegar staðfest er í Raunumhverfi og skráningin þín er í loftinu birtist greiðsluþrepið á gátlistanum þínum sem lokið.

Bilanaleit

Það segir að upplýsingarnar séu rangar.

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.

Prófunarumhverfi virkaði en Raunumhverfi ekki.

Prófunar- og Raunumhverfi nota ólíka lykla. Veldu Raunumhverfi í fellivalmyndinni fyrir umhverfi og límdu inn raunlyklana frá greiðslugáttinni.

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

Sóley staðfestir sjálfkrafa með því að athuga hjá greiðslugáttinni þinni, svo bíddu augnablik og endurhladdu þá síðuna — staðfesting berst yfirleitt innan sekúndna. Ef hún staðfestist ekki, athugaðu hvort lyklarnir séu raunlyklarnir (Production). Fyrir Straumur skaltu líka athuga hvort undirritunarleyndarmálið sé rétt.

É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ðslu-/SecurePay-að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.