Kortagreiðslur — ValitorPay

Með ValitorPay tekur þú við kortagreiðslum í gegnum greiðslugátt Rapyd, bæði á netinu og í kassakerfinu. Á netinu greiða viðskiptavinir með korti í vefversluninni, á tilboðum og pöntunum í þjónustugáttinni og fyrir áskriftir. Í kassakerfinu greiða þeir á posa frá Rapyd sem er tengdur kassanum.

Í köflunum Áður en þú byrjar, Uppsetning og Dagleg notkun er fyrst fjallað um netgreiðslur og síðan um posa.

Áður en þú byrjar

Kortagreiðslur byggja á samningi þínum við Rapyd. Exigo setur viðbæturnar upp í Odoo.

Það sem þarf fyrir netgreiðslur

Þetta útvegar þú hjá Rapyd:

• Færsluhirðingarsamning og ValitorPay-greiðslugátt. Þú þarft samning um færsluhirðingu korta hjá Rapyd og ValitorPay-greiðslugáttina virka á söluaðilareikningnum. Án greiðslugáttarinnar hafnar Rapyd lyklunum sem „unauthorized“.
• 3-D Secure fyrir allar kortategundir, virkt á samningnum. Hver ný kortagreiðsla byrjar á 3-D Secure-staðfestingu áður en kortið er skuldfært.
• Yfirferð Rapyd á vefsíðunni. Rapyd fer yfir vefsíðuna, þar á meðal síðu með skilmálum, áður en greiðslugáttin er virkjuð.
• Alla gjaldmiðla sem vefverslunin selur í. Odoo sendir gjaldmiðil og upphæð pöntunarinnar óbreytt til ValitorPay, svo samningurinn þarf að ná yfir hvern gjaldmiðil.
• API-lykil fyrir ValitorPay-greiðslugáttina. Raunlykil fyrir stöðuna Virkjað, sem Rapyd sendir í öruggum eða dulkóðuðum skilaboðum, og prófunarlykil (UAT) fyrir stöðuna Prófunarhamur.

Í Odoo þarf appið Fjárhagur eða Reikningagerð fyrir greiðsludagbókina, Vefsíðu með vefverslun ef selt er á vefnum og áskriftaappið (Enterprise) ef viðskiptavinir greiða áskriftir með vistuðu korti.

Það sem þarf fyrir posa

• Posa frá Rapyd/Valitor, sem tengjast kassanum í gegnum CloudLink-þjónustu Rapyd. Exigo hefur prófað tenginguna með PAX A920 posa.
• Raðnúmer hvers posa, flokkuð eftir verslunum. Þú útvegar þau.
• API-lykil fyrir CloudLink, sem er settur á hvern posagreiðslumáta í Odoo.
• Heimild hjá Rapyd fyrir vefslóð Odoo. Rapyd/ValitorPay þarf að heimila vefslóðina sem tekur við svörum frá posunum. Svör posanna berast ekki á aðrar vefslóðir.
• Kassakerfi í Odoo. Exigo setur viðbótina upp og parar posana.

Það sem Odoo gerir ekki með ValitorPay

• Endurgreiðsla netgreiðslu á kort úr Odoo. Kreditreikningur í Odoo endurgreiðir ekki kortið.
• Apple Pay og Google Pay eða aðrar hraðgreiðslur.
• Handvirk skuldfærsla eftir á (manual capture).
• Vistuð kort við venjuleg kaup. Viðskiptavinir geta ekki vistað kortið við greiðslu og vistuð ValitorPay-kort eru ekki boðin þegar greitt er. Kort eru aðeins vistuð fyrir áskriftir.
• Aðrir færsluhirðar. Viðbótin styður eingöngu ValitorPay-greiðslugátt Rapyd.

Uppsetning

Exigo sér um þau skref þar sem Exigo er nefnt.

Uppsetning netgreiðslna

1. Exigo setur upp viðbótina Exigo Payment Provider: ValitorPay. Hún býr til greiðslumiðlunina ValitorPay með greiðslumátunum Card, Visa, Mastercard, Maestro og Amex.
2. Exigo eða stjórnandi hjá þér opnar greiðslumiðlunina: farðu í Fjárhagur ‣ Stillingar ‣ Greiðslur á netinu ‣ Greiðslumiðlanir og veldu ValitorPay. Hún er líka í Vefsíða ‣ Stillingar ‣ Vefverslun ‣ Greiðslumiðlanir.
3. Exigo setur API-lykilinn í reitinn API Key á flipanum Aðgangur. Reiturinn er lykilorðsreitur og verður að vera útfylltur nema staðan sé Óvirkt.
4. Veldu Staða:
   • Prófunarhamur sendir allar beiðnir í prófunarumhverfi Rapyd og þarf prófunarlykil. Í þessari stöðu sjá aðeins innskráðir notendur Odoo greiðslumiðlunina.
   • Virkjað sendir greiðslur í raunumhverfi Rapyd og þarf raunlykil. Odoo merkir greiðslumiðlunina þá Birt og viðskiptavinir sjá hana.
   • Óvirkt slekkur á greiðslumiðluninni.
5. Exigo eða bókari velur Greiðsludagbók á flipanum Stillingar. Hver kortagreiðsla sem tekst er bókuð sem greiðsla í þessari dagbók. Reiturinn verður að vera útfylltur nema staðan sé Óvirkt.
6. Ef þörf krefur skaltu takmarka hvenær greiðslumiðlunin býðst í hlutanum Framboð á sama flipa: eftir löndum, gjaldmiðlum og hámarksupphæð.
7. Exigo prófar með þér. Fyrst eru gerð kaup í stöðunni Prófunarhamur með prófunarlykli og innskráðum notanda í Odoo. Síðan er skipt í stöðuna Virkjað með raunlyklinum og gerð raunveruleg kaup.

Skipta um API-lykil

Nýr API-lykill kemur frá Rapyd þegar Rapyd skiptir um lykil, með nýjum samningi og þegar þú flytur færsluhirðingu til Rapyd. Kortagreiðslur í vefversluninni virka ekki fyrr en nýi lykillinn er kominn inn í Odoo. Exigo getur sett lykilinn inn fyrir þig, eða stjórnandi hjá þér gerir það svona:

1. Fáðu nýja lykilinn frá Rapyd. Rapyd sendir raunlykilinn í öruggum eða dulkóðuðum skilaboðum.
2. Farðu í Fjárhagur ‣ Stillingar ‣ Greiðslur á netinu ‣ Greiðslumiðlanir og veldu ValitorPay.
3. Settu nýja lykilinn í reitinn API Key á flipanum Aðgangur.
4. Láttu reitinn Staða standa á Virkjað og vistaðu.
5. Gerðu lítil raunveruleg kaup í vefversluninni og kláraðu 3-D Secure-staðfestinguna. Exigo mælir með slíkum kaupum eftir hver lyklaskipti.
6. Ef kaupin mistakast, opnaðu pöntunina og lestu ástæðuna í spjallinu. Ef nýi lykillinn virkar ekki heldur, hafðu samband við Exigo.

[Skjámynd: greiðslumiðlunin ValitorPay, flipinn Credentials með reitnum API Key og Staða = Virkjað]

Uppsetning posa

Exigo setur posana upp með þér. Þú útvegar raðnúmer hvers posa, eftir verslunum.

1. Exigo setur upp viðbótina Exigo POS: Valitor/Rapyd CloudLink API.
2. Farðu í Kassakerfi ‣ Stillingar ‣ Greiðslumátar og stofnaðu eða opnaðu kortagreiðslumátann.
3. Settu Integration á Terminal og Integrate with á ValitorPay.
4. Settu Mode á Production. Sjálfgefið er Test, sem sendir beiðnir í prófunarumhverfi Rapyd. Raunverulegir posar virka aðeins í Production.
5. Fylltu út þessa þrjá skyldureiti:
   • Rapyd/Valitor API key: CloudLink API-lykillinn.
   • Rapyd/Valitor Terminal identifier: raðnúmer posans. Hvert raðnúmer má aðeins koma einu sinni fyrir í gagnagrunninum.
   • Rapyd/Valitor Timeout: hve margar sekúndur posinn hefur til að svara fyrstu beiðni. Sjálfgefið er 5.
6. Vistaðu, smelltu á Register Terminal og staðfestu pörunina á posanum ef hann biður um það. Hakið Rapyd/Valitor device is paired kviknar þegar Rapyd hefur svarað Odoo.
7. Bættu greiðslumátanum við kassann og veldu Dagbók fyrir hann, eins og fyrir aðra kortagreiðslumáta.

[Skjámynd: greiðslumáti í kassakerfi með Integration = Terminal, Integrate with = ValitorPay, Mode = Production og þremur Rapyd/Valitor-reitum]

Dagleg notkun

Greiðsla í vefversluninni

1. Viðskiptavinurinn velur kortagreiðslu og fyllir út kortanúmer, nafn korthafa, gildistíma og öryggisnúmer (CVC).
2. Greiðsluhnappurinn verður virkur þegar kortanúmer, gildistími og CVC eru gild. Fjögurra stafa CVC (Amex) er tekið gilt.
3. Eftir að viðskiptavinurinn smellir á greiðsluhnappinn birtist 3-D Secure-staðfesting frá bankanum hans í stað greiðslusíðunnar.
4. Þegar bankinn hefur samþykkt skuldfærir Odoo kortið og sendir viðskiptavininn á síðu með stöðu greiðslunnar.

[Skjámynd: kortaformið í vefversluninni með fjórum reitum og greiðsluhnappi]

Þegar greiðslan tekst verður færslan Staðfest og Odoo:

• staðfestir tilboðið ef greidd upphæð nær heildarupphæð pöntunarinnar;
• sendir staðfestingu;
• býr til og sendir reikning ef sjálfvirk reikningagerð er virk;
• bókar greiðslu í greiðsludagbókinni.

Þegar greiðslan mistekst skráir Odoo villuna og ástæðuna í spjallið á pöntuninni. Ástæður frá ValitorPay eru á ensku, til dæmis „3D Secure card verification failed.“ eða „ValitorPay standard card payment failed.“

Viðskiptavinurinn sér þá skilaboð á ensku, til dæmis „We are not able to process your payment.“ eða „3DS card verification failed. Please try again or contact support.“

Á staðfestingarsíðu pöntunarinnar birtist rauður hnappur, Reyna greiðslu aftur, alltaf þegar greiðsla pöntunarinnar er ekki staðfest. Hann setur sömu pöntun aftur í körfuna, svo lengi sem pöntunin er enn ósent tilboð. Ef svar ValitorPay barst aldrei fer viðskiptavinurinn aftur í verslunina með tóma körfu og enginn hnappur birtist.

[Skjámynd: staðfestingarsíða pöntunar með rauða hnappnum Reyna greiðslu aftur]

Ef viðskiptavinurinn fer af greiðslusíðunni áður en hún klárast lýkur sjálfvirk keyrsla við pöntunina, svo framarlega sem ValitorPay hafði svarað. Sjá kaflann Sjálfvirkar keyrslur.

Áskriftir og vistuð kort

• Þegar áskriftarpöntun er greidd á netinu vistar Odoo kortið. ValitorPay býr til sýndarkort fyrir endurteknar greiðslur og Odoo geymir það sem vistað kort viðskiptavinarins.
• Dagleg áskriftarkeyrsla skuldfærir vistaða kortið við endurnýjun, án 3-D Secure.
• Ef útgefandi kortsins svarar með nýju korti uppfærir Odoo vistaða kortið sjálfkrafa.
• Kort sem starfsmaður slær inn fyrir viðskiptavin, til dæmis í síma, þarf samt 3-D Secure-samþykki viðskiptavinarins.

Greiðsla í posa

1. Veldu ValitorPay-greiðslumátann á greiðsluskjánum. Greiðslan fer ekki sjálfkrafa í posann: línan sýnir Payment request pending og hnappinn Senda.
2. Smelltu á Senda. Línan sýnir Request sent og síðan Waiting for card þegar posinn hefur tekið við beiðninni, ásamt tilkynningunni „ValitorPay POS, sale received in the terminal“.

[Skjámynd: greiðsluskjár kassans með ValitorPay-línu sem sýnir Payment request pending og hnappinn Senda]

• Samþykkt: Kassinn hringir bjöllu, línan sýnir Payment Successful og tilkynning segir „ValitorPay POS, transaction completed“. Kortanúmer, heimildarnúmer og söluaðilanúmer vistast á greiðslunni og prentast á kvittunina sem „Card number:“, „Authorization code:“ og „Merchant ID:“. Ef Automatically validate order er virkt, sem er sjálfgefið, er pöntunin staðfest.
• Hafnað: Gluggi segir „ValitorPay POS, transaction declined“ og línan sýnir Transaction cancelled með hnappnum Reyna aftur.
• Hætt við: Ef hætt er við á meðan beðið er eftir posanum biður Odoo posann að hætta við og posinn svarar „ValitorPay POS, transaction cancelled“. Ef hætt er við áður en Odoo hefur svarað birtist „The sale request is not completed yet.“
• Posinn upptekinn eða villa: Gluggarnir „ValitorPay POS, terminal is busy“, „ValitorPay POS, terminal error“ og „Error processing payment callback“ birtast og hægt er að reyna aftur. Ef samband við netþjóninn rofnar birtist „Could not connect to the Odoo server, please check your internet connection and try again.“ og línan fær hnappinn Reyna aftur.

Posinn notar ensku og prentar ekki sjálfur. Upphæðir fara í posann í heilum krónum og posagreiðslur eru eingöngu í íslenskum krónum.

Greiðslurnar eru í Kassakerfi ‣ Pantanir ‣ Greiðslur. Hver greiðsla sýnir ValitorPay Card number, ValitorPay Authorization Code, ValitorPay Merchant ID og ValitorPay JSON, sem er óunnið svar posans.

Endurgreiðslur

• Netgreiðslur: Ekki er hægt að endurgreiða kortagreiðslu úr Odoo. Kreditreikningur í Odoo endurgreiðir ekki kortið.
• Posar: Endurgreiðslupöntun sem er greidd með ValitorPay-greiðslumátanum sendir endurgreiðslu í posann. Línan sýnir Refund in process og ekki er hægt að hætta við endurgreiðslulínu.

Bókun greiðslna og uppgjör frá Rapyd

• Netgreiðslur: Hver kortagreiðsla sem tekst verður bókuð greiðsla í greiðsludagbók greiðslumiðlunarinnar og greiddir reikningar eru afstemmdir sjálfkrafa. Skýring greiðslunnar er tilvísun færslunnar í Odoo og tilvísun ValitorPay, með bandstriki á milli. Allar kortategundir, debet og kredit, fara í sömu dagbók.
• Posagreiðslur eru bókaðar þegar kassalotunni er lokað, í dagbók greiðslumátans.
• Uppgjör frá Rapyd: Odoo les ekki inn uppgjörsskrár frá Rapyd. Útgreiðslur Rapyd eru stemmdar af við þessar greiðslur með venjulegri bankaafstemmingu í Odoo.

Sjálfvirkar keyrslur

Viðbæturnar frá Exigo hafa engar eigin sjálfvirkar keyrslur. Þessar keyrslur úr Odoo sjálfu vinna með ValitorPay-greiðslur:

Þegar eitthvað fer úrskeiðis

Vandamálin eru talin upp eftir því hve oft þau koma upp núna, algengust fyrst. Ástæða misheppnaðrar netgreiðslu sést í spjallinu á pöntuninni.

Kortagreiðslur í vefversluninni hættu að virka

Ástæðan er oftast sú að Rapyd hefur skipt um API-lykil, eða að nýr lykill fylgdi nýjum samningi eða nýrri greiðslugátt.

• Fáðu gildandi lykil frá Rapyd og settu hann inn eins og lýst er í kaflanum Skipta um API-lykil.
• Lestu ástæðuna í spjallinu á pöntuninni. Ef enginn lykill er skráður mistekst greiðslan með villunni „API Key is not set“.
• Gerðu lítil raunveruleg kaup til að staðfesta að greiðslur virki.

Hafðu samband við Exigo ef nýi lykillinn virkar ekki heldur, eða ef þú vilt að Exigo setji hann inn.

Greiðslan fer ekki í posann

• Mode á greiðslumátanum þarf að vera Production. Sjálfgefið er Test.
• „No device token found“ þýðir að posinn er ekki paraður. Smelltu á Register Terminal á greiðslumátanum.
• „ValitorPay POS Payment Method not found.“ þýðir að kassinn hefur engan ValitorPay-greiðslumáta.
• „Multiple POS ValitorPay Payment Methods are linked to the POS session“ þýðir að kassinn hefur fleiri en einn ValitorPay-greiðslumáta. Hann má aðeins hafa einn.
• Rapyd þarf að hafa heimilað vefslóð Odoo sem tekur við svörum frá posunum.

Hafðu samband við Exigo til að setja viðbótina upp og para posana.

Viðskiptavinir sjá ekki kortagreiðslu í vefversluninni

Ástæðan hefur oftast verið sú að nýr færsluhirðingarsamningur var ekki orðinn virkur hjá Rapyd.

• Fáðu staðfest hjá Rapyd að samningurinn sé virkur.
• Athugaðu hvort reiturinn Staða sé Virkjað og greiðslumiðlunin Birt. Í stöðunni Prófunarhamur sjá aðeins innskráðir notendur Odoo hana.
• Athugaðu hlutann Framboð á flipanum Stillingar. Takmarkanir eftir löndum, gjaldmiðlum eða hámarksupphæð geta falið greiðslumiðlunina.

Hafðu samband við Exigo ef allt þetta er í lagi.

Kortið var skuldfært en pöntunin er enn tilboð

Pöntunin getur líka birst sem yfirgefin karfa, eða greiðslan lent á rangri pöntun.

• Odoo staðfestir pöntun aðeins þegar greidd upphæð nær heildarupphæð hennar.
• Ef ValitorPay svaraði en vafri viðskiptavinarins kláraði ekki, lýkur sjálfvirk keyrsla við pöntunina innan um 10 mínútna. Bíddu í 10–15 mínútur.
• Ef svar ValitorPay barst Odoo aldrei er færslan ókláruð og pöntunin áfram tilboð, sem getur birst sem yfirgefin karfa.
• Opnaðu pöntunina og lestu stöðu færslunnar og villuna í spjallinu.
• Athugaðu hjá Rapyd hvort skuldfærslan sé til áður en þú biður viðskiptavininn að greiða aftur.

Hafðu samband við Exigo og gefðu upp tilvísun pöntunarinnar og hvenær greitt var.

„Unauthorized“ þegar API-lykillinn er settur inn

Söluaðilareikningurinn hjá Rapyd hefur ekki ValitorPay-greiðslugáttina. Biddu Rapyd að virkja hana og settu lykilinn síðan inn aftur.

Hafðu samband við Exigo ef lyklinum er enn hafnað eftir að Rapyd hefur staðfest að þjónustan sé virk.

Kassinn bíður eftir svari frá posanum

Odoo tekur við öllum svörum posans, líka höfnun án heimildarnúmers, og sýnir afgreiðslumanninum villu ef vinnsla svars mistekst. Svar posans tengist réttri greiðslu þótt afgreiðslumaðurinn hafi opnað aðra pöntun á meðan.

• Ef kassinn sýnir ekki að greiðslan tókst, athugaðu í posanum hvort salan var samþykkt áður en þú rukkar aftur.
• Force done merkir línuna greidda án staðfestingar frá posanum, svo athugaðu fyrst í posanum hvort salan var samþykkt.
• Force cancel hættir við afturköllun sem bíður svars frá posanum.

Hafðu samband við Exigo ef kassinn bíður án nokkurra skilaboða.

Viðskiptavinur var rukkaður tvisvar

Odoo stöðvar nýja greiðslu þegar pöntunin er skráð fullgreidd, eða þegar önnur greiðslubeiðni fyrir sömu pöntun er í vinnslu á sama augnabliki. Skuldfærsla sem ValitorPay framkvæmdi en Odoo skráði aldrei telst hins vegar ekki greiðsla í Odoo.

• Athugaðu báðar skuldfærslurnar hjá Rapyd.
• Ekki er hægt að endurgreiða kortið úr Odoo.

Hafðu samband við Exigo ef pöntunin í Odoo sýnir ekki greiðsluna rétt.

Greiðsla í erlendum gjaldmiðli mistekst

Odoo sendir gjaldmiðil pöntunarinnar óbreyttan til ValitorPay, svo samningurinn við Rapyd þarf að ná yfir gjaldmiðilinn. Biddu Rapyd að bæta honum við samninginn.

Hafðu samband við Exigo ef greiðslan mistekst enn eftir að Rapyd hefur bætt gjaldmiðlinum við.

Greiðslu viðskiptavinar var hafnað

Algengar ástæður eru útrunnið kort, fullnýtt heimild á kortinu og 3-D Secure-staðfesting sem viðskiptavinurinn kláraði ekki. Útrunnið kort og fullnýtt heimild eru höfnun frá útgefanda kortsins, ekki villa í vefversluninni.

• Lestu ástæðuna í spjallinu á pöntuninni, til dæmis „3D Secure card verification failed.“
• Viðskiptavinurinn getur reynt aftur með hnappnum Reyna greiðslu aftur á staðfestingarsíðu pöntunarinnar.

Hafðu samband við Exigo ef greiðslum er hafnað með 3-D Secure-villu þótt viðskiptavinurinn hafi klárað staðfestinguna.

Odoo 17

Uppsetning og notkun eru í meginatriðum þær sömu í Odoo 17. Munurinn er þessi:

• Íslenska í vefversluninni. Kortareitirnir og villuboðin eru á íslensku, til dæmis Kortanúmer, Nafn korthafa og Gildir til (MM/YY), og lykilreiturinn heitir API lykill.
• Hnappurinn til að reyna aftur heitir Retry Payment, á ensku.
• Force done og Force cancel á posalínum sem bíða eru viðbót frá Exigo í Odoo 17. Í Odoo 19 eru þeir hluti af Odoo sjálfu.
• Greiðsla tekin fyrir aðra pöntun. Ef afgreiðslumaðurinn hefur farið í aðra pöntun þegar posinn svarar, klárar Odoo 17 pöntunina sem var greidd og birtir „The card payment was taken for another order. That order is paid and still open.“
• Uppsetning posa er sú sama: sömu reitir, sami hnappur Register Terminal og Mode er sjálfgefið Test.

Sjá einnig

• Netgreiðslur
• Greiðslur á netinu
• Pöntun og greiðsla
• Áskriftir og sjálfvirkar greiðslur
• Greiðslutæki
• Afstemming bankafærslna
• Kreditnótur og endurgreiðslur
• Hafa samband við Exigo