sóley

Tengdu greiðslugáttina þína

Skref-fyrir-skref leiðbeiningar til að tengja þína eigin kortagreiðslugátt við Sóley. Finndu greiðslugáttina þína hér að neðan — flestir nota Teya.

Þú skráir aldrei webhook eða opnar þróunarstjórnborð. Þegar lyklarnir þínir eru vistaðir staðfestir Sóley hverja greiðslu sjálfkrafa með því að athuga hjá greiðslugáttinni þinni. Uppsetningin er bara 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 heldur aldrei utan um fjármunina þína og rukkar 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 SecurePay velkomstpóstinum — engin uppsetning í stjórnborði nauðsynleg.

Skref

  1. 1Finndu SecurePay velkomstpó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 þú ert tilbúin(n) fyrir alvöru greiðslur.

Hvað á að líma inn

Merchant ID
Tölulegt söluaðilanúmer, efst í velkomstpó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 í velkomstpó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 callback-slóð svo við vitum þegar greiðsla klárast. Þ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 callback-slóðina sem Sóley sýnir þér í 'Skráðu þessa callback-slóð' reitnum á greiðsluþrepinu. Vistaðu hana í Straumur-stjórnborðinu.
  6. 6Til baka í Sóley, hafðu umhverfið á Prófunarumhverfi og vistaðu. Keyrðu eina prófunarbókun — þegar hún staðfestist, skiptu yfir í Raunumhverfi og límdu raunlyklana + skráðu callback-slóð raunumhverfis á 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.
Callback-slóð (þú skráir hana)
Webhooks / Notifications → bættu við tilkynningu → límdu slóðina úr 'Skráðu þessa callback-slóð' 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 — engir alvöru peningar hreyfast. Raunlyklar (Production) taka við alvöru kortagreiðslum.

  1. 1Byrjaðu í Prófunarumhverfi. Límdu prófunarlyklana og vistaðu.
  2. 2Keyrðu prófunarbókun frá upphafi til enda til að staðfesta að greiðsluhlekkurinn opnist og klárist.
  3. 3Þegar það virkar, skiptu Umhverfis-fellilistanum yfir í Raunumhverfi og límdu raunlyklana.
  4. 4Gerðu eina litla alvöru bókun til að staðfesta að peningarnir 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. Þú ert búin(n).
  • •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 keyrð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 klárað.

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. Skiptu Umhverfis-fellilistanum yfir í Raunumhverfi og límdu 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 gefðu því augnablik og endurhladdu — 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ð leiðum þig í gegnum þetta.