4 - Vefþjónustur

4.1 - HefjaSendingu

Áður en hægt er að senda inn færslur þarf fyrst að kalla á fallið HefjaSendingu sem skila BunkaID sem þarf að fylgja öllum færslum sem eru sendar inn.

Attention

Það er mjög mikilvægt að aldrei sé sent inn sama bunkanúmer tvisar fyrir ákveðið samningsnúmer. Þetta er óháð tíma, t.d. má ekki sendi inn sama bunkanúmer eftir 1 ár.

4.1.1 - Skilgreiningar

4.1.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
Samningsnumer S 6 6 M Boðgreiðslu-samningsnúmer söluaðila
Bunkanumer S 7 7 M Hlaupandi númer sem söluaðili ákveður sjálfur. Heppilegt að láta fyrsta bunka vera 0000001. Bunkanúmer má ekki senda inn aftur fyrir annann bunka á sama samningsnúmeri. Þetta er óháð tíma.
SamningsKennitala S 10 10 M Kennitala söluaðila.
BunkaUpphaed S - - M !!! attention Þetta er ekki lengur í notkun og hefur engin áhrif á framvindu bunkans.
FjoldiFaerslna S - - M !!! attention Þetta er ekki lengur í notkun og hefur engin áhrif á framvindu bunkans.
Syndarnumerasending B - - M True ef verið er að senda inn sýndarnúmer.

4.1.1.2 - Response

Svæði Type Len. min Len. max Notkun Lýsing
Villunumer N 1 3 M Villunúmer. Sjá töflu í 4.1.3.
Villuskilabod S 1 - M Lýsing á villu. Er tómt ef engin villa.
VilluLogID N 1 - M Ef upp kemur kerfisvilla þá er þetta ID villu í kerfum Valitor.
KeyrsluTimiMillisek N 1 - M Hversu langan tíma tók að keyra fyrirspurn.
BunkiID S 26 26 M ID bunka. Ef villa þá er 0 skilað. Þetta ID er notað við innsendingu færslna.

4.1.2 - Dæmi

4.1.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<HefjaSendingu xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<Bunkanumer>0000001</Bunkanumer>
<SamningsKennitala>6012966135</SamningsKennitala>
<BunkaUpphaed></BunkaUpphaed >
<FjoldiFaerslna></FjoldiFaerslna >
<Syndarnumerasending>vaxtalaust</Syndarnumerasending>
</HefjaSendingu>
</soap:Body> </soap:Envelope>

4.1.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<HefjaSendingu xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
<BunkiID>15.10.2012 11:21:14:731000</BunkiID>
</HefjaSendingu>

4.1.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<HefjaSendingu xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>260</Villunumer>
<Villuskilabod>Samningsnúmer og bunkanúmer hefur komið inn áður.</Villuskilabod>
<VilluLogID>0</VilluLogID>
<BunkiID>0</BunkiID>
</HefjaSendingu>

4.1.3. Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
226 Bunka upphæð vantar.
227 Bunkaupphæð verður að vera tölustafir.
228 Fjölda færslna vantar.
229 Fjöldi færslna verður að vera tölustafir.
242 Notandanafn x hefur ekki aðgang að samningum fyrir kennitöluna yyyyyyyyyy.
249 Sýndarnúmerasending verður að vera true eða false.
260 Samningsnúmer og bunkanúmer hefur komið inn áður.
300 Samningsnúmer er ekki til.
301 Kennitala er ekki til.
302 Samningsnúmer xxxxxx tilheyrir ekki kennitölunni yyyyyyyyyy.
304 Samningsnúmer er ekki opinn boðgreiðslusamningur.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.2 - SendaInn

Þetta fall tekur á móti öllum færslunum.

Attention

Mikilvægt að senda eina færslu í einu og bíða eftir svari. Það verður að klára að senda inn allar færslur innan 96 tíma.

4.2.1 - Skilgreiningar

4.2.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
BunkiID S 26 26 M ID bunka í kerfum Valtior.
Samningsnumer S 6 6 M Boðgreiðslu-samningsnúmer söluaðila
Bunkanumer S 7 7 M Hlaupandi númer sem söluaðili ákveður sjálfur. Heppilegt að láta fyrsta bunka vera 0000001. Bunkanúmer má ekki senda inn aftur fyrir annann bunka á sama samningsnúmeri. Þetta er óháð tíma.
SamningsKennitala S 10 10 M Kennitala söluaðila.
Tilvisunarnumer S 7 7 M Notað sem færslunúmer í kerfum Valitor. Sama tilvísunarnúmer og kortnúmer mega ekki koma fyrir tvisar í bunka. Er einkvæmt fyrir kortnúmer í bunka.
Kortnumer S 11 19 M Kortnúmer sem á að skuldfæra.
Gildistimi S 4 4 O Er á forminu MMÁÁ. Ef þetta er sýndarnúmer má ekki senda inn gildistíma.
Kortategund S 1 1 M V fyrir VISA kort. M fyrir MasterCard.
Upphaed S 1 7 M Upphæð sem á að skuldfæra. Ef óskað er eftir að greiða inn á kort er sett mínusmerki strax fyrir framan upphæðina.
KennitalaHandhafa S 10 10 O Kennitala handhafa.
KennitalaRetthafa S 10 10 O Kennitala greiðanda.
Skyring S 10 10 O Kennitala söluaðila.

4.2.1.2 - Response

Svæði Tegund Len. min Len. max Notkun Lýsing
Villunumer N 1 3 M Villunúmer. Sjá töflu í 4.1.3. Ef villunúmer er 0 tókst að sendi inn færslu.
Villuskilabod S 1 - M Lýsing á villu. Er tómt ef engin villa.
VilluLogID N 1 - M Ef upp kemur kerfisvilla þá er þetta ID villu í kerfum Valitor.
KeyrsluTimiMillisek N 1 - M Hversu langan tíma tók að keyra fyrirspurn.

4.2.2 - Dæmi

4.2.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SendaInn xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<BunkiID>15.10.2012 11:21:14:731000</BunkiID>
<Samningsnumer>60000</Samningsnumer>
<Bunkanumer>0000001</Bunkanumer>
<SamningsKennitala>6012966135</SamningsKennitala>
<Tilvisunarnumer>9348333</Tilvisunarnumer> <Kortnumer>4166453986001010</Kortnumer> <Gildistimi>0409</Gildistimi> <Kortategund>V</Kortategund> <Upphaed>1000</Upphaed> <KennitalaHandhafa>2112683579</KennitalaHandhafa> <KennitalaRetthafa>1010801234</KennitalaRetthafa> <Skyring>ADSL</Skyring>
</SendaInn>
</soap:Body> </soap:Envelope>

4.2.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<SendaInn xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
</SendaInn>

4.2.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<SendaInn xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>259</Villunumer>
<Villuskilabod>Þetta kortnúmer og tilvísunarnúmer hefur komið fyrir áður í þessum bunka.</Villuskilabod>
<VilluLogID>0</VilluLogID>
</SendaInn>

4.2.3. Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
230 Tilvísunarnúmer verður að vera 7 tölustafir.
231 Kortnúmer vantar.
232 Kortnúmer verður að vera 11 til 19 tölustafir.
233 Gildistími verður að vera 4 tölustafir.
234 Kortategund vantar.
235 Kortategund verður að vera einn bókstafur. T.d. V fyrir VISA.
236 Upphæð vantar.
237 Upphæð verður að vera tölustafir.
238 Kennitala handhafa verður að vera 10 tölustafir.
239 Kennitala rétthafa verður að vera 10 tölustafir.
240 Skýring má ekki vera lengra en 30 stafir.
241 BunkiID vantar.
243 Ekki til opinn bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer. Bunki stofnaður fyrir meira en 96 tímum telst ekki opinn.
247 Kortnúmer er ekki sýndarnúmer. Sýndarnúmer er 16 tölustafir þar sem tölustafir 2 til 6 eru 99999.
256 Tilvísunarnúmer vantar.
259 Þetta kortnúmer og tilvísunarnúmer hefur komið fyrir áður í þessum bunka.
261 Kortnúmer ógilt.
262 Það á ekki að senda inn gildistíma þegar sýndarnúmer er notað.
263 Kennitalan yyyyyyyyyy hefur ekki aðgang að sýndarnúmeri.
266 Samningsnúmer xxxxxx getur ekki tekið á móti MasterCard kortum.
267 Kortnúmer er sýndarnúmer. Þessi bunki getur ekki tekið á móti sýndarnúmerum.
268 Upphæð verður að vera minni en 10.000.000 kr.
305 Þjónustan styður ekki kortategund kortnúmers.
306 Þjónustan styður ekki kortategund.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.3 - SendinguLokid

Þegar búið er að senda inn allar færslur er kallað á SendinguLokid.

Attention

Bunki stofnaður fyrir meira en 96 tímum telst ekki opinn. Ef reynt er að loka slíkum bunka koma villuskilaboð 243.

4.3.1 - Skilgreiningar

4.3.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
BunkiID S 26 26 M ID bunka í kerfum Valtior.
Samningsnumer S 6 6 M Boðgreiðslu-samningsnúmer söluaðila
Bunkanumer S 7 7 M Hlaupandi númer sem söluaðili ákveður sjálfur. Heppilegt að láta fyrsta bunka vera 0000001. Bunkanúmer má ekki senda inn aftur fyrir annann bunka á sama samningsnúmeri. Þetta er óháð tíma.
SamningsKennitala S 10 10 M Kennitala söluaðila.

4.3.2 - Dæmi

4.3.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SendinguLokid xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<BunkiID>15.10.2012 11:21:14:731000</BunkiID>
<Samningsnumer>60000</Samningsnumer>
<Bunkanumer>0000001</Bunkanumer>
<SamningsKennitala>6012966135</SamningsKennitala>
</SendinguLokid>
</soap:Body> </soap:Envelope>

4.3.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<SendinguLokid xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
</SendinguLokid>

4.3.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<SendinguLokid xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>257</Villunumer>
<Villuskilabod> Fjöldi innsenndra færslna er 45, en gefið var upp að 47 færslur yrðu sendar inn.</Villuskilabod>
<VilluLogID>0</VilluLogID> </SendinguLokid>

4.3.3 - Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
3 User (xxx) does not have access to Web Service (yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
241 BunkiID vantar.
242 Notandanafn x hefur ekki aðgang að samningum fyrir kennitöluna yyyyyyyyyy.
243 Ekki til opinn bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer. Bunki stofnaður fyrir meira en 96 tímum telst ekki opinn.
257 Fjöldi innsenndra færslna er x, en gefið var upp að y færslur yrðu sendar inn.
258 Bunkaupphæð innsenndra færslna er x krónur, en gefið var upp að bunkaupphæð yrði y krónur.
300 Samningsnúmer er ekki til.
301 Kennitala er ekki til.
302 Samningsnúmer xxxxxx tilheyrir ekki kennitölunni yyyyyyyyyy.
304 Samningsnúmer er ekki opinn boðgreiðslusamningur.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.4 - LaekkaBunka

Error

Notkun LaekkaBunka aðgerðarinnar hefur verið hætt í Boðgreiðslukerfi Valitor.

Aðgerðinni LaekkaBunka hefur nú verið útfasað úr Boðgreiðslukerfi Valitor. Þeir sem hafa þegar lokið innleiðingu Boðgreiðslna geta í enn kallað í aðgerðina en það hefur engin áhrif. Ef kallað er á hana í dag skilar hún einungis tómu svari.

4.4.1 - Dæmi - tómt svar

<?xml version="1.0" encoding="utf-8"?>
<LaekkaBunka xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
</LaekkaBunka>

4.5 - NidurstodurSendingar

Hægt er að kalla á NidurstodurSendingar mörgum sinnum. Gæti þurft ef það kemur timeout einhverra hluta vegna.

4.5.1 - Skilgreiningar

4.5.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
BunkiID S 26 26 M ID bunka í kerfum Valtior.
Samningsnumer S 6 6 M Boðgreiðslu-samningsnúmer söluaðila
Bunkanumer S 7 7 M Hlaupandi númer sem söluaðili ákveður sjálfur. Heppilegt að láta fyrsta bunka vera 0000001. Bunkanúmer má ekki senda inn aftur fyrir annann bunka á sama samningsnúmeri. Þetta er óháð tíma.
SamningsKennitala S 10 10 M Kennitala söluaðila.
SkilaFaerslurTokst S - - M Á að skila líka færslum sem tókust, eða einungis þeim sem tókst ekki að skuldfæra.

4.5.2 - Dæmi

4.5.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<NidurstodurSendingar xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<BunkiID>15.10.2012 11:21:14:731000</BunkiID>
<Samningsnumer>60000</Samningsnumer>
<Bunkanumer>0000001</Bunkanumer>
<SamningsKennitala>6012966135</SamningsKennitala>
<SkilaFaerslurTokst>false</SkilaFaerslurTokst> </NidurstodurSendingar>
</soap:Body> </soap:Envelope>

4.5.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<NidurstodurSendingar xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
<Bunki>
<BunkaFaersla>
<BunkiID>15.10.2012 11:21:14:731000</BunkiID> <Samningsnumer>60000</Samningsnumer> <Bunkanumer>0000001</Bunkanumer> <Keyrsludagur>15.10.2012 13:01:15:984000</Keyrsludagur>
<FjoldiFaerslna>9</FjoldiFaerslna> <FjoldiFaerslnaTokstAdSkuldfaera>8</FjoldiFaerslnaTokstAdSkuldfaera> <BunkaUpphaedVar>9000</BunkaUpphaedVar> <BunkaUpphaedVerdur>8000</BunkaUpphaedVerdur>
</BunkaFaersla> <NyKortnumer> <ListiKortnumer>
<Kortnumer> <Innsent>4177453986001011-0209</Innsent>
<Nytt>4112678298001010-0810</Nytt>
<KennitalaHandhafa>2312683579</KennitalaHandhafa>
<NafnHandhafa/></NafnHandhafa>
<Tilvisunarnumer>9348432</Tilvisunarnumer>
</Kortnumer> </ListiKortnumer>
<NyKortnumer>
<FaerslurHafnad> <ListiFaerslaHafnad>
<FaerslaHafnad> <Tilvisunarnumer>9348333</Tilvisunarnumer>
<Kortnumer>4166453986001010</Kortnumer>
<Upphaed>1000</Upphaed>
<KennitalaHandhafa>2112683579</KennitalaHandhafa>
<NafnHandhafa></NafnHandhafa> <KennitalaRetthafa>1010801234</KennitalaRetthafa> <Skyring>ADSL</Skyring>
<Astaeda>17</Astaeda>
</FaerslaHafnad> </ListiFaerslaHafnad>
</FaerslurHafnad>
</Bunki>
</NidurstodurSendingar>

4.5.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<LaekkaBunka xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>243</Villunumer>
<Villuskilabod>Ekki til opinn bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer. Bunki stofnaður fyrir meira en 96 tímum telst ekki opinn.</Villuskilabod>
<VilluLogID>0</VilluLogID> </LaekkaBunka>

Ef gildistími korts er ekki gefinn upp kemur: 

4166453986001010-

Ef gildistími er gefinn upp, kemur hann á eftir bandstrikinu: 

4166453986001010-0810

Astaeda getur haft eftirfarandi gildi:

00 = Heimild.
01 = Hringið eftir heimild (hafið samband við útgefanda korts)
02 = Hafið samband við útgefanda korts, sérstök ástæða.
04 = Takið kort
05 = Synjun.
07 = Takið kort og klippið. (Sviksamlegt not á korti önnur en "41" Glatað eða "43" Stolið)
11 = VIP Heimild. (ADVICE)
12 = Óheimil úttekt.
13 = Óheimil upphæð.
14 = Óheimilt kortnúmer.
15 = Útgefandi korts ekki til.
19 = Reynið aftur.
41 = Takið kort og klippið, týnt kort. (Svar táknar sviksamleg not)
43 = Takið kort og klippið, stolið kort. (Svar táknar sviksamleg not)
51 = Yfir heimildarmörkum.
52 = Engin tékkareikningur.
53 = Engin sparireikningur.
54 = Synjun, útrunnið kort.
55 = Rangt PIN númer.
57 = Úttekt ekki heimil fyrir korthafa.
61 = Korthafi fer yfir hámarksfjárhæð. (ADVICE)
62 = Takmarkað kort.
65 = Teljari yfir hámark. (ADVICE)
75 = PIN teljari yfir hámark. (ADVICE)
82 = Rangt CVV. (ADVICE)
86 = Getur ekki staðfest PIN.
91 = Næ ekki sambandi við útgefanda.
93 = Úttekt ekki heimiluð vegna lagatakmarkanna.
96 = Bilun í kerfi.
99 = Reynið aftur.

Það geta bæst við aðrar ástæður, og því er mikilvægt að gera ráð fyrir því þegar skrifað er á móti þessu.

Í NyKortnumer er listi yfir þau kortnúmer sem var reynt að skuldfæra þegar ekki var hægt að skuldfæra innsent kortnúmer. Leitað er að kennitölu greiðanda og athugað hvort sú kennitala sé greiðandi af öðrum kortum sem hægt er að nota.

Mjög mikilvægt

Mikilvægt er að uppfæra kortnúmer í kerfi söluaðila samkvæmt listanum sem er skilað.

Í FaerslurTokst og FaerslurHafnad birtist samt innsenda kortnúmerið, þótt annað kortnúmer hafi verið skuldfært.

Ef innsent kortnúmer er lokað og það finnst annað kort sem tilheyrir sömu kennitölu er reynt að skuldfæra það kort. Ef það kort er í vanskilum og ekki tekst að skuldfæra það, birtist það samt í listanum yfir ný kortnúmer.

Vinsamlegast athugið

Eingöngu innsend kortnúmer sem birtast í listanum FaerslurTokst og FaerslurHafnad. „Ný kortnúmer“ birtast aldrei í þessum listum.

Ef villa 259 „Ekki til lokaður bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer.“ kemur þrátt fyrir að það tókst að kalla á fallið SendinguLokid (það skilaði villunúmeri 0) þá er ekki búið að koma gögnum úr boðgreiðsluvefkerfi yfir í stórtölvuumhverfi til vinnsludeildar Valitor.

4.5.3 - Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
241 BunkiID vantar.
242 Notandanafn x hefur ekki aðgang að samningum fyrir kennitöluna yyyyyyyyyy.
243 Ekki til opinn bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer. Bunki stofnaður fyrir meira en 96 tímum telst ekki opinn.
251 SkilaFaerslurTokst verður að vera true eða false.
252 Upphæð vantar.
253 Upphæð verður að vera tölustafir.
254 Fjöldi færslna vantar.
255 Fjöldi færslna verður að vera tölustafir.
259 Ekki til lokaður bunki fyrir innsent BunkiID, samningsnúmer og bunkanúmer.
300 Samningsnúmer er ekki til.
301 Kennitala er ekki til.
302 Samningsnúmer xxxxxx tilheyrir ekki kennitölunni yyyyyyyyyy.
304 Samningsnúmer er ekki opinn boðgreiðslusamningur.
352 Keyrslu innsendra færslna er ekki lokið.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.6 - SkilaSyndarnumeriUtFraKortnumeri

Sýndarkortnúmer er 16 tölustafir þar sem tölustafir 2 til 6 eru 99999, t.d. 4999997698764321.
Fyrsti tölustafur í sýndarkortnúmeri er sami og fyrsti tölustafur í kortnúmeri. Nánari upplýsingar má finna í kaflanum Sýndarkortnúmer

Warning

Frá og með 31.Október 2020 uppfyllir þessi vefþjónusta ekki skilyrði reglugerðar um sterka auðkenningu (SCA). Eldri kort, skráð fyrir 31.Október 2020, eru þó undanþegin þessum skilyrðum. En nýjar skráningar eru í meiri áhættu á að verða hafnað af útgefendum korta. Vinsamlegast verið í sambandi við Valitor til að fá upplýsingar um nýjar þjónustur sem uppfylla að fullu skilyrði reglugerðar um sterka auðkenningu.

4.6.1 - Skilgreiningar

4.6.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
SamningsKennitala S 10 10 M Kennitala söluaðila.
Kortnumer S 11 19 M Kortnúmer sem á að skila sýndarnúmeri fyrir.
Gildistimi S 4 4 M Er á forminu MMÁÁ.

Vinsamlegast athugið

Fyrir þá sem hafa þegar innleitt Boðgreiðslur Valitor verður svæðið Gildistimi valkvætt til 30. apríl 2020.
Að þeim tíma loknum mun aðgerðin hætta að virka sé gildistími korts ekki sendur með.

4.6.2 - Dæmi

4.6.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SkilaSyndarnumeriUtfraKortnumeri xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<SamningsKennitala>6012966135</SamningsKennitala>
<Kortnumer>4166453986001010</Kortnumer> <Gildistimi>0409</Gildistimi> </SkilaSyndarnumeriUtfraKortnumeri>
</soap:Body> </soap:Envelope>

4.6.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<SkilaSyndarnumeriUtFraKortnumeri xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID> <Syndarnumer>4999998765438764</Syndarnumer>
</SkilaSyndarnumeriUtFraKortnumeri>

4.6.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<SkilaSyndarnumeriUtfraKortnumeri xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>305</Villunumer>
<Villuskilabod>Þjónustan styður ekki kortategund kortnúmers.</Villuskilabod>
<VilluLogID>0</VilluLogID> </SkilaSyndarnumeriUtfraKortnumeri>

4.6.3 - Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
231 Kortnúmer vantar.
232 Kortnúmer verður að vera 11 til 19 tölustafir.
233 Gildistími verður að vera 4 tölustafir.
242 Notandanafn x hefur ekki aðgang að samningum fyrir kennitöluna yyyyyyyyyy.
261 Kortnúmer ógilt.
270 Gildistimi vantar
271 Gildistimi útrunninn
305 Þjónustan styður ekki kortategund kortnúmers.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.7 - SkilaKortnumeriUtFraSyndarnumeri

Fallið skilar einungis síðustu 4 tölustöfunum í kortnúmeri, þótt nafnið gefið til kynna að öllu kortnúmerinu sé skilað.

4.7.1 - Skilgreiningar

4.7.2 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
SamningsKennitala S 10 10 M Kennitala söluaðila.
Syndarnumer S 16 16 M Sýndarkotnúmer sem á að skila síðustu 4 úr kortnúmeri fyrir.

4.7.2 - Dæmi

4.7.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SkilaKortnumeriUtFraSyndarnumeri xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<SamningsKennitala>6012966135</SamningsKennitala>
<Syndarnumer>4999998765438764</Syndarnumer> </SkilaKortnumeriUtFraSyndarnumeri>
</soap:Body> </soap:Envelope>

4.7.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<SkilaKortnumeriUtFraSyndarnumeri xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID> <Syndarnumer>****-****-****-8764</Syndarnumer>
</SkilaKortnumeriUtFraSyndarnumeri>

4.7.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<SkilaKortnumeriUtFraSyndarnumeri xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>250</Villunumer>
<Villuskilabod> Ógilt sýndarnúmer. Sýndarnúmer er 16 tölustafir þar sem tölustafir 2 til 6 eru 99999.</Villuskilabod>
<VilluLogID>0</VilluLogID> </SkilaKortnumeriUtFraSyndarnumeri>

4.7.3 - Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
246 Sýndarnúmer er ekki til.
250 Ógilt sýndarnúmer. Sýndarnúmer er 16 tölustafir þar sem tölustafir 2 til 6 eru 99999.
263 Kennitalan yyyyyyyyyy hefur ekki aðgang að sýndarnúmeri.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.8 - EydaBunka

Ekki er hægt að eyða bunka sem búið er að loka. Ef bunka er eytt er hægt að senda inn sama bunkanúmer aftur.

4.8.1 - Skilgreiningar

4.8.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
Samningsnumer S 6 6 M Boðgreiðslu-samningsnúmer söluaðila
Bunkanumer S 7 7 M Hlaupandi númer sem söluaðili ákveður sjálfur
Heppilegt að láta fyrsta bunka vera 0000001
Bunkanúmer má ekki senda inn aftur fyrir annann bunka á sama samningsnúmeri
Þetta er óháð tíma.
SamningsKennitala S 10 10 M Kennitala söluaðila

4.8.2 - Dæmi

4.8.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<EydaBunka xmlns="http://api.valitor.is/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<Bunkanumer>0000001</Bunkanumer>
<SamningsKennitala>6012966135</SamningsKennitala> </EydaBunka>
</soap:Body> </soap:Envelope>

4.8.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<EydaBunka xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
</EydaBunka>

4.8.2.3 - Response villa

<?xml version="1.0" encoding="utf-8"?>
<EydaBunka xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>264</Villunumer>
<Villuskilabod>Ekki hægt að eyða bunka þar sem innsendingu er lokið.</Villuskilabod>
<VilluLogID>0</VilluLogID> </EydaBunka>

4.8.3 - Villur

Númer Lýsing
1 Vefþjónustu ID er ekki til.
2 Rangt notandanafn eða lykilorð.
3 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID=yyy).
4 Notandanafn (xxx) hefur ekki aðgang að vefþjónustu (VefthjonustaID yyy) frá Ip tölunni zzz.
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
242 Notandanafn x hefur ekki aðgang að samningum fyrir kennitöluna yyyyyyyyyy.
264 Ekki hægt að eyða bunka þar sem innsendingu er lokið.
265 Bunkanúmerið xxxxxx fannst ekki fyrir samningsnúmerið yyyyyy.
300 Samningsnúmer er ekki til.
301 Kennitala er ekki til.
302 Samningsnúmer xxxxxx tilheyrir ekki kennitölunni yyyyyyyyyy.
304 Samningsnúmer er ekki opinn boðgreiðslusamningur.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)

4.9 - BunkaSkrar

Stofnar bunka með færslum sem senda þarf inn á XML eða JSON formi.
Hægt er að senda inn fleiri en einn bunka í einni keyrslu.

Vinsamlegast athugið

Þegar söluaðili sendir inn kort eða sýndarkort sem ekki hafa komið inn áður þarf að fletta þeim upp og geta fyrstu innsendingar með þessari aðgerð tekið smá tíma ef ný kort eru mörg. Næstu innsendingar verða svo snöggar eftir það, þar sem möppun fyrir kortnúmerin eru til staðar og ekki þarf uppflettingu.

Í þeim tilfellum þegar að ekki eru notuð sýndarnúmer þá er gildistíma korts krafist.

Mikilvægar upplýsingar

Villunúmer í svari geta annahvort komið undir <SkilabodBunkaSkrar><Villunumer>, og hefur þá keyrslan sem heild ekki tekist. Eða undir <SkilabodBunkaSkrar><BunkaInnsending><BunkiInnsending><Villunumer>, og hefur þá stakur bunki í innsendingunni ekki tekist.

4.9.1 - Skilgreiningar

4.9.1.1 - Request

Svæði Tegund Len. min Len. max Notkun Lýsing
Notandanafn S 1 50 M Notandanafn söluaðila fyrir vefþjónustuna
Lykilord S 1 50 M Lykilorð söluaðila fyrir vefþjónustuna
Bunkar S - - M Bunkinn sjálfur, færslurnar á JSON eða XML formi
Tegund S 1 50 M Skilgreining hvort færslur séu sendar inn á JSON eða XML formi
TegundTilkynningar S 1 50 O Hvernig á að senda tilkynningu á söluaðila um framvindu bunka
Í boði er tölvupóstur og/eða webhook
Lögleg gildi eru Email, Webhook og EmailAndWebhook
Email S 1 50 O Netfang sem senda á tilkynningar á
Webhook S 1 100 O Vefslóð söluaðila sem senda á tilkynningar á
4.9.1.1.1 - Tilkynningar

Hægt er að fá tilkynningar um framvindu bunkans eftir að búið er að senda hann inn.

Tilkynningar geta borist í tölvupóstfang söluaðila, og/eða á sérstakt vefsvæði söluaðila sem getur tekið við tilkynningar skilaboðum (Webhook).

Webhook vefsíða söluaðila þarf að innihalda fall sem getur tekið við POST skeyti sem inniheldur eina færibreytu. - Message : Skilaboð til söluaðila um framvindu bunkans.

Ásamt því að innihalda þessi skilaboð þá er gildi sem heitir Bodgreidsla-Signature í header á skeytinu með undirskrift sem söluaðili getur notað til að staðfesta að skeytið komi frá Boðgreiðslukerfi Valitor.

Undirskriftin er SHA512 hash gildi af innra bunka id sem söluaðili fær til baka úr SkilabodBunkaSkrar vefþjónustu svarinu.

Söluaðili getur því framkvæmt þetta hash á innra bunka id, og borið saman við það sem kemur í header breytunni Bodgreidsla-Signature í webhook skeytinu.

Dæmi:
Bunki með InnraBunkiId 001d2e61-4f01-4453-ae64-07f4ca204663 skilar tilkynningarskeyti með 799C363CC2BF16E84DE2C3AFAAA2125B37578A0E9ABAEFA51485496A51D2649B8A771E120B6514BEAB3A9F509BE911EF357FEBA335A9D76E6FAD063D9323A3E7 í hausnum Bodgreidsla-Signature.

4.9.1.2 - Response

Svæði Tegund Len. min Len. max Notkun Lýsing
Villunumer N 1 3 M Villunúmer. Sjá töflu í 4.9.3
Villuskilabod S 1 - M Lýsing á villu
Er tómt ef engin villa
VilluLogID N 1 - M Ef upp kemur kerfisvilla þá er þetta ID villu í kerfum Valitor
KeyrsluTimiMillisek N 1 - M Hversu langan tíma tók að keyra fyrirspurn
BunkaInnsending O - - M Listi af BunkiInnsending, ef sendir voru inn margir bunkar þá koma jafn mörg svör í þennan lista
4.9.1.2.1 - BunkiInnsending Response Object
Svæði Tegund Len. min Len. max Notkun Lýsing
BunkaNumer S 7 7 M Bunkanúmer sem söluaðili sendi inn
BunkiID S 26 26 M ID bunka
Þetta er notað til að sækja niðurstöður sendingar í NidurstodurSendingar vefþjónustunni
VilluLogID N 1 - M Ef upp kemur kerfisvilla þá er þetta ID villu í kerfum Valitor
InnraBunkiId S 36 36 M GUID (Globally Unique Identifier) sem táknar auðkenni bunkans í innra Boðgreiðslukerfi Valitor
Má nota til að staðfesta tilkynningar sendingu þegar Webhook er notað til að fá tilkynningar
Villunumer N 1 3 M Villunúmer fyrir þennan tiltekna bunka í innsendingunni
Sjá töflu 4.9.3

4.9.2 - Dæmi

4.9.2.1 - Request

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<BunkaSkrar>
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Bunkar><BodgreidsluSkraningar>
  <Bunkar>
    <Bunki>
      <BunkaFaersla>
        <Samningsnumer>231517</Samningsnumer>
        <SamningsKennitala>1110793319</SamningsKennitala>
        <Bunkanumer>8892889</Bunkanumer>
        <SyndarnumerSending>true</SyndarnumerSending>
      </BunkaFaersla>
      <Faerslur>
        <Faersla>
          <Tilvisunarnumer>0000000</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
        <Faersla>
          <Tilvisunarnumer>0000001</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
        <Faersla>
          <Tilvisunarnumer>0000002</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
        <Faersla>
          <Tilvisunarnumer>0000003</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
        <Faersla>
          <Tilvisunarnumer>0000004</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
        <Faersla>
          <Tilvisunarnumer>0000005</Tilvisunarnumer>
          <Upphaed>2400</Upphaed>
          <Kortnumer>2999990237099289</Kortnumer>
          <Gildistimi />
        </Faersla>
      </Faerslur>
    </Bunki>
  </Bunkar>
</BodgreidsluSkraningar></Bunkar>
<Tegund>XML</Tegund>
<TegundTilkynningar>EmailAndWebhook</TegundTilkynningar>
<Email>merchant@test.is</Email>
<Webhook>https://merchant.is/webhook</Webhook>
</BunkaSkrar>
</soap:Body> </soap:Envelope>

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<BunkaSkrar>
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Bunkar>{"Bunkar":[{"BunkaFaersla":{"Samningsnumer":"231517","SamningsKennitala":"1110793319","Bunkanumer":"4142018","BunkaUpphaed":null,"FjoldiFaerslna":null,"SyndarnumerSending":"true"},"Faerslur":[{"Tilvisunarnumer":"0000000","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""},{"Tilvisunarnumer":"0000001","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""},{"Tilvisunarnumer":"0000002","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""},{"Tilvisunarnumer":"0000003","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""},{"Tilvisunarnumer":"0000004","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""},{"Tilvisunarnumer":"0000005","Upphaed":"2400","Kortnumer":"2999990237099289","Gildistimi":""}]}]}</Bunkar>
<Tegund>JSON</Tegund>
<TegundTilkynningar>EmailAndWebhook</TegundTilkynningar>
<Email>merchant@test.is</Email>
<Webhook>https://merchant.is/webhook</Webhook>
</BunkaSkrar>
</soap:Body> </soap:Envelope>

4.9.2.2 - Response

<SkilabodBunkaSkrar xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod/>
<VilluLogID>0</VilluLogID>
<KeyrsluTimiMillisek>0</KeyrsluTimiMillisek>
<BunkaInnsending>
<BunkiInnsending>
<Bunkanumer>4142018</Bunkanumer>
<BunkiId>2020-04-29-23.27.25.830000</BunkiId>
<InnraBunkiId>17e7681b-5f78-44ba-b3d6-652768cff42c</InnraBunkiId>
<Villunumer>0</Villunumer>
</BunkiInnsending>
</BunkaInnsending>
</SkilabodBunkaSkrar>

4.9.2.3 - Response villa

<SkilabodBunkaSkrar xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.valitor.is/">
<Villunumer>0</Villunumer>
<Villuskilabod/>
<VilluLogID>0</VilluLogID>
<KeyrsluTimiMillisek>0</KeyrsluTimiMillisek>
<BunkaInnsending>
<BunkiInnsending>
<Bunkanumer>4142018</Bunkanumer>
<BunkiId>2020-05-13-11.16.19.353000</BunkiId>
<InnraBunkiId>ed72f30e-29fb-418b-81b5-5ceca46bd35f</InnraBunkiId>
<Villunumer>0</Villunumer>
</BunkiInnsending>
<BunkiInnsending>
<Bunkanumer>4142018</Bunkanumer>
<Villunumer>230</Villunumer>
<Villuskilabod>Tilvísunarnúmer verður að vera 7 tölustafir.</Villuskilabod>
</BunkiInnsending>
</BunkaInnsending>
</SkilabodBunkaSkrar>

4.9.3 - Villur

Villukóði Lýsing
220 Samningsnúmer vantar.
221 Samningsnúmer verður að vera 6 tölustafir. Hægt er að fylla út með 0 fyrir framan.
222 Bunkanúmer vantar.
223 Bunkanúmer verður að vera 7 tölustafir.
224 Kennitölu eiganda samnings vantar.
225 Kennitala eiganda samnings verður að vera 10 tölustafir.
230 Tilvísunarnúmer verður að vera 7 tölustafir.
231 Kortnúmer vantar.
232 Kortnúmer verður að vera 11 til 19 tölustafir.
233 Gildistími verður að vera 4 tölustafir.
236 Upphæð vantar.
237 Upphæð verður að vera tölustafir.
247 Kortnúmer er ekki sýndarnúmer. Sýndarnúmer er 16 tölustafir þar sem tölustafir 2 til 6 eru 99999.
249 Sýndarnúmerasending verður að vera true eða false.
256 Tilvísunarnúmer vantar.
261 Kortnúmer ógilt.
267 Kortnúmer er sýndarnúmer. Þessi bunki getur ekki tekið á móti sýndarnúmerum.
268 Upphæð verður að vera minni en 10.000.000 kr.
270 Gildistima vantar
271 Gildistimi utrunnin
272 Bunka skrá vantar.
273 Tegund bunka skrár vantar.
274 Tegund bunka skrár inniheldur ekki löglegt gildi. Lögleg gildi eru 'XML' og 'JSON'.
275 Bunki er ekki á gildu XML formi. Villa : '{exception.Message}'
276 Ekki er hægt að færa bunka frá XML formi yfr á JSON form. Villa : '{exception.Message}'.
277 Ekki löglegt netfang.
278 Ekki lögleg TegundTilkynningar. Lögleg gildi eru 'Email', 'Webhook' eða 'EmailAndWebhook'. Webhook er vefsíða á svæði söluaðila sem getur tekið við skilaboðum frá Boðgreiðslukerfi Valitor.
279 Netfang vantar
280 Webhook vantar
281 Webhook verður að vera löglegt URL.
282 Vantar bunka færslu
305 Þjónustan styður ekki kortategund kortnúmers.
500 Kerfisvilla. (Getur komið mismunandi texti.)
900 Óþekkt villa. (Getur komið mismunandi texti.)