4 - Non-3DSecure Web Services

Warning

Usage of these web services is not in full compliance with the new SCA Regulatory Update.
Use 3DSecure web services instead.

4.1 - FaSyndarkortnumer

"FaSyndarkortnumer" is Icelandic for "get the virtual card number". An attempt is made to receive authorization for 0 ISK to verify the information received and that the card is all right, if successful then the function returns a virtual card number. It is possible to use virtual card numbers for all contract numbers linked to submitted Icelandic SS numbers, i.e. SamningsKennitala.

4.1.1 - Definitions

4.1.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
Samningsnumer N 6 6 M Merchant's contract no.
SamningsKennitala N 10 10 M Contract's Icelandic SS no.
PosiID N 1 - M POS terminal ID received from Valitor.
Kortnumer N 16 16 M Card no. used to create a virtual card no. for.
Gildistimi N 4 4 M Card expiration date written MMYY.
Oryggisnumer N 3 4 O Verification code on reverse side of card. If this is provided, the system will perform a correct 0kr card check to verify the card. If not provided the system will perform an authorization equal to 150 ISK (Depending on the merchant currency) to verify the card and then cancel the authorization. We reccomend that the verification code to be used because in future versions the verification code will be mandatory.
Stillingar AN 1 250 O Additional parameters. Not currently in use.
Villuskilabod AN 1 16 M Error description. Is empty if there is no error.
Villunumer N 1 3 M Error no. Is 0 if no error. See table in 4.1.3.
VilluLogID N 1 - M Error ID in Valitor logs.
Syndarkortnumer N 16 16 M Virtual card no.

4.1.2 - Examples

4.1.2.1 - Request example

<?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>
<FaSyndarkortnumer xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala> <PosiID>1</PosiID>
<Kortnumer>4166453986006987</Kortnumer>
<Gildistimi>0315</Gildistimi>
<Oryggisnumer>123</Oryggisnumer>
<Stillingar></Stillingar>
</FaSyndarkortnumer>
</soap:Body> </soap:Envelope>

4.1.2.2 - Response example

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

4.1.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<SyndarkortnumerSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>232</Villunumer>
<Villuskilabod>Gildistími korts er útrunninn.</Villuskilabod>
<VilluLogID>0</VilluLogID>
<Syndarkortnumer />
</SyndarkortnumerSkilabod>

4.1.3 - Error Codes

Error code Description
1 Web Service ID does not exist.
2 Wrong user name or password.
3 User name (xxx) does not have access to the Web Service (VefthjonustaID=yyy).
4 User name (xxx) does not have access to the Web Service from IP no. zzz.
200 Contract number is missing.
201 The contract number must be 6 digits. A 0 may be used as the first digit.
202 Contract number x does not exist.
204 Contract number x is not associated with Icelandic SS number y.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
209 POS terminal ID is missing.
210 POS terminal ID must be in digits only.
211 Card no. is missing.
212 Card no. must be 11 to 19 digits.
213 Card no. is void.
214 Expiration date is missing.
215 Expiration date must be 4 digits.
216 Verification code is missing.
217 Verification code is too long.
218 Authorization not received for card no. – not possible to create a virtual card no.. Different messages may appear.
232 Card expiration date is past.
233 POS termainal ID x is not associated with contract number y.
235 Received card numbers are virtual card numbers. Card numbers transmitted must be regular card numbers.
500 System error. (Explanation text may vary.)
999 Unknown error. (Explanation text may vary.)

We suggest that coding allows for the possibility that Web Services may return other error numbers than those listed in this document.

4.2 - FaHeimild

This function is used to seek authorization, that is, when the card is to be charged that is behind the virtual card number.

4.2.1 - Definitions

4.2.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
Samningsnumer N 6 6 M Merchant's contract no.
SamningsKennitala N 10 10 M Contract's Icelandic SS no.
PosiID B 1 - M POS terminal ID received from Valitor.
Syndarkortnumer N 16 16 M Virtual card no. received from the function FaSyndarkortnumer.
Upphaed N 1 - M Amount to be charged.
If amount is 0 then there is no authorization request performed, the service will just return an empty response with 0 error code.
Gjaldmidill AN 3 3 M Currency, e.g. ISK, USD, EUR, DKK.
Stillingar AN 1 250 O Additional parameters

4.2.1.2 - Response

Field Type Len. min Len. max Usage Description
Villuskilabod AN 1 16 M Error description. Is empty if there is no error
Villunumer N 1 3 M Error number. Is 0 if there is no error. See table 4.2.3
VilluLogID N 1 - M Error ID in Valitor logs
Kvittun/Receipts OB - - - Kvittun/Receipts object
4.2.1.2.1 - Receipts Response Object
Field Type Len. min Len. max Usage Description
 VerslunNafn AN 1 - M Name of store.
 VerslunHeimilisfang AN 1 - M Store address.
 VerslunStadur AN 1 - M Place of store.
 TegundKorts AN 1 - M Card type, e.g. VISA.
 TegundKortsKodi N 3 3 M Card type code.
Example:
400 (VISA)
500 (MasterCard)
530 (AMEX)
 Dagsetning AN 10 10 M Authorization date.
 Timi AN 1 - M Authorization time.
 Kortnumer AN 19 19 M Starred card no. where last 4 digits appear.
 Upphaed AN 19 19 M Amount.
 Faerslunummer N 5 5 M Transaction no.
 Faersluhirdir AN 19 19 M Acquirer name and phone no.
 Heimildarnumer AN 6 6 M Authorization no.
 StadsetningNumer N 4 4 M Location no., default 0001.
 UtstodNumer N 4 4 M Terminal no., default 0001.
 BuidAdOgilda B - - M True if transaction canceled.
 Bunkanumer AN 8 8 M Batch numbers with prefix B.
 Soluadilinumer AN 8 8 M Merchant contract no. with prefix S.
 Hugbunadarnumer N 11 11 M Permanent no.: 11101020000.
 PosiID N 1 - M POS terminal ID allocated by Valitor.
 PinSkilabod - - - - Not used.
 Vidskiptaskilabod AN 1 - M Text, currency and amount.
 F22_1til4 N 4 4 M Permanent no.: 5101.
 LinaC1 N 3 3 M Permanent no.: 060.
 LinaC2 N 4 4 M Permanent no.: 1509.
 LinaC3 AN 1 - M Text and transaction no.
 LinaC4 AN 1 - M Text and authorization no.
 LinaD1 - - - - Not used.
 LinaD2 - - - - Not used.
 TegundAdgerd AN 11 11 M Permanent text: SÍMGREIÐSLA.
 FaerslunumerUpphafleguFaerslu AN 1 - M Text and transaction no.
 TerminalID N 8 8 M Terminal ID.

4.2.2 - Examples

4.2.2.1 - Request example

<?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>
<FaHeimild xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala> <PosiID>1</PosiID>
<Syndarkortnumer>4999993986001010</Syndarkortnumer>
<Upphaed>100</Upphaed>
<Gjaldmidill>ISK</Gjaldmidill>
<Stillingar></Stillingar>
</FaHeimild>
</soap:Body> </soap:Envelope>

4.2.2.2 - Response example

<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn>123.is ehf</VerslunNafn>
<VerslunHeimilisfang>Pósthólf 12063</VerslunHeimilisfang>
<VerslunStadur>Reykjavik</VerslunStadur>
<TegundKorts>VISA</TegundKorts> <TegundKortsKodi>400</TegundKortsKodi>
<Dagsetning>14.05.2009</Dagsetning>
<Timi>09:38</Timi>
<Kortnumer>****-****-****-6987</Kortnumer>
<Upphaed>100</Upphaed>
<Faerslunumer>26711</Faerslunumer>
<Faersluhirdir>Valitor, sími: 525 2000</Faersluhirdir>
<Heimildarnumer>114355</Heimildarnumer>
<StadsetningNumer>0001</StadsetningNumer>
<UtstodNumer>0001</UtstodNumer>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer>B0000469</Bunkanumer>
<Soluadilinumer>S0039189</Soluadilinumer>
<Hugbunadarnumer>11101020000</Hugbunadarnumer>
<PosiID>1</PosiID>
<PinSkilabod />
<Vidskiptaskilabod>VIÐSKIPTI ISK: 100</Vidskiptaskilabod>
<F22_1til4/>5101</F22_1til4>
<LinaC1>060</LinaC1>
<LinaC2>1509</LinaC2>
<LinaC3>FÆRSLUNR: 0000001</LinaC3>
<LinaC4>HEIMILD:114355</LinaC4>
<LinaD1 />
<LinaD2 />
<TegundAdgerd>SÍMGREIÐSLA</TegundAdgerd>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID>11100004</TerminalID>
</Kvittun>
</HeimildSkilabod>

4.2.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>233</Villunumer>
<Villuskilabod>PosiID 89 tilheyrir ekki samningsnúmerinu 000122.</Villuskilabod>
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn/>
<VerslunHeimilisfang/>
<VerslunStadur/>
<TegundKorts/>
<Dagsetning/>
<Timi/>
<Kortnumer/>
<Upphaed/>
<Faerslunumer/>
<Faersluhirdir/>
<Heimildarnumer/>
<StadsetningNumer/>
<UtstodNumer/>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer/>
<Soluadilinumer/>
<Hugbunadarnumer/>
<PosiID/>
<PinSkilabod/>
<Vidskiptaskilabod/>
<F22_1til4/>
<LinaC1/>
<LinaC2/>
<LinaC3/>
<LinaC4/>
<LinaD1/>
<LinaD2/>
<TegundAdgerd/>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID/>
</Kvittun>
</HeimildSkilabod>

4.2.3 - Error Codes

Error code Description
1 Web Service ID does not exist.
2 Wrong user name or password.
3 User (xxx) does not have access to Web Service (yyy).
4 User (xxx) does not have access to Web Service (yyy) from IP (zzz).
200 Contract number is missing.
201 The contract number must be 6 digits. A 0 may be used as the first digit.
202 Contract number x does not exist.
204 Contract number x is not associated with Icelandic SS number y.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
209 POS terminal ID is missing.
210 POS terminal ID must be in digits only.
219 Virtual card number is missing.
220 Virtual card number is void. Virtual card number is 16 digits where digits 2 through 9 are 99999.
221 Virtual card number does not exist.
222 The amount is missing.
224 The currency is missing.
225 The currency must be three letters.
226 Contract number x is not listed for currency y.
227 SS no. x does not have access to virtual card number y .
228 Authorization not received, reason: xxxxxxxxxx.
229 Failed to reimburse. Different messages can appear.
230 POS terminal ID x is not associated with SS no. y.
231 The card associated with virtual card number x has expired. The card ends in y.
235 Error: location of card holder is too short.
500 System error. (Different messages may appear)
999 Unknown error. (Different messages may appear)

We suggest that coding allows for the possibility that Web Services may return other error numbers than those listed in this document.

4.3 - FaAdeinsheimild

This function is used to reserve authorization. If the authorization is to be used then call NotaAdeinsheimild with the transaction number in fileld Faerslunumer.

This fuction has the same input and output functionality as FaHeimild. With the exception of CVV being mandatory.

Error Code Description
216 Cvv is missing or too short
217 Cvv is too long.

4.4 - NotaAdeinsheimild

This function is used to activate authorization that has been made with FaAdeinsheimild. You need to reference the original authorization with transaction number in field Faerslunumer.

This fuction has the same input and output functionality as FaHeimild, except currency (Gjaldmidill) in input.

4.5 - FaEndurgreitt

This function is used for reimbursement, that is, when a sum is to be deposited on a card associated with a virtual card number.

4.5.1 - Definitions

4.5.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
Samningsnumer N 6 6 M Merchant's contract no.
SamningsKennitala N 10 10 M Contract's Icelandic SS no.
PosiID B 1 - M POS terminal ID received from Valitor.
Syndarkortnumer N 16 16 M Virtual card no. received from the function FaSyndarkortnumer.
Upphaed N 1 - M Amount to be charged.
Gjaldmidill AN 3 3 M Currency, e.g. ISK, USD, EUR, DKK.
Stillingar AN 1 250 O Additional parameters. Not currently in use.

4.5.1.2 - Response

Field Type Len. min Len. max Usage Description
Villuskilabod AN 1 16 M Error description. Is empty if there is no error
Villunumer N 1 3 M Error number. Is 0 if there is no error. See table 4.2.3
VilluLogID N 1 - M Error ID in Valitor logs
Kvittun/Receipts OB - - - Kvittun/Receipts object
4.5.1.2.1 - Receipts Response Object
Field Type Len. min Len. max Usage Description
 VerslunNafn AN 1 - M Name of store.
 VerslunHeimilisfang AN 1 - M Store address.
 VerslunStadur AN 1 - M Place of store.
 TegundKorts AN 1 - M Card type, e.g. VISA.
 TegundKortsKodi N 3 3 M Card type code, e.g. 400 for VISA
 Dagsetning AN 10 10 M Authorization date.
 Timi N 5 5 M Authorization time.
 Kortnumer AN 19 19 M Starred card no. where last 4 digits appear.
 Upphaed N 1 1 M Amount.
 Faerslunummer N 5 5 M Transaction no.
 Faersluhirdir AN - - M Acquirer name and phone no.
 Heimildarnumer N 6 6 M Authorization no.
 StadsetningNumer N 4 4 M Location no., default 0001.
 UtstodNumer N 4 4 M Terminal no., default 0001.
 BuidAdOgilda B - - M True if transaction canceled.
 Bunkanumer AN 8 8 M Batch numbers with prefix B.
 Soluadilinumer AN 8 8 M Merchant contract no. with prefix S.
 Hugbunadarnumer N 11 11 M Permanent no.: 11101020000.
 PosiID N 1 - M POS terminal ID allocated by Valitor.
 PinSkilabod - - - - Not used.
 Vidskiptaskilabod AN 1 - M Text, currency and amount.
 F22_1til4 N 4 4 M Permanent no.: 5101.
 LinaC1 N 3 3 M Permanent no.: 060.
 LinaC2 N 4 4 M Permanent no.: 1509.
 LinaC3 AN 1 - M Text and transaction no.
 LinaC4 AN 1 - M Text and authorization no.
 LinaD1 - - - - Not used.
 LinaD2 - - - - Not used.
 TegundAdgerd AN 11 11 M Permanent text: ENDURGREIDSLA.
 FaerslunumerUpphafleguFaerslu - - - M Not used.
 TerminalID N 8 8 M Terminal ID.

4.5.2 - Example

4.5.2.1 - Request example

<?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>
<FaEndurgreitt xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala> <PosiID>1</PosiID>
<Syndarkortnumer>4999993986001010</Syndarkortnumer>
<Upphaed>50</Upphaed>
<Gjaldmidill>ISK</Gjaldmidill>
<Stillingar></Stillingar>
</FaEndurgreitt>
</soap:Body> </soap:Envelope>

4.3.2.2 - Response example

<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn>123.is ehf</VerslunNafn>
<VerslunHeimilisfang>Pósthólf 12063</VerslunHeimilisfang>
<VerslunStadur>Reykjavik</VerslunStadur>
<TegundKorts>VISA</TegundKorts> <TegundKortsKodi>400</TegundKortsKodi>
<Dagsetning>14.05.2009</Dagsetning>
<Timi>09:38</Timi>
<Kortnumer>****-****-****-6987</Kortnumer>
<Upphaed>50</Upphaed>
<Faerslunumer>26711</Faerslunumer>
<Faersluhirdir>Valitor, sími: 525 2000</Faersluhirdir>
<Heimildarnumer>114355</Heimildarnumer>
<StadsetningNumer>0001</StadsetningNumer>
<UtstodNumer>0001</UtstodNumer>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer>B0000469</Bunkanumer>
<Soluadilinumer>S0039189</Soluadilinumer>
<Hugbunadarnumer>11101020000</Hugbunadarnumer>
<PosiID>1</PosiID>
<PinSkilabod />
<Vidskiptaskilabod>VIÐSKIPTI ISK: 50</Vidskiptaskilabod>
<F22_1til4/>5101</F22_1til4>
<LinaC1>060</LinaC1>
<LinaC2>1509</LinaC2>
<LinaC3>FÆRSLUNR: 0000001</LinaC3>
<LinaC4>HEIMILD:114355</LinaC4>
<LinaD1 />
<LinaD2 />
<TegundAdgerd>SÍMGREIÐSLA</TegundAdgerd>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID>11100004</TerminalID>
</Kvittun>
</HeimildSkilabod>

4.5.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>233</Villunumer>
<Villuskilabod>PosiID 89 tilheyrir ekki samningsnúmerinu 000122.</Villuskilabod>
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn/>
<VerslunHeimilisfang/>
<VerslunStadur/>
<TegundKorts/>
<Dagsetning/>
<Timi/>
<Kortnumer/>
<Upphaed/>
<Faerslunumer/>
<Faersluhirdir/>
<Heimildarnumer/>
<StadsetningNumer/>
<UtstodNumer/>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer/>
<Soluadilinumer/>
<Hugbunadarnumer/>
<PosiID/>
<PinSkilabod/>
<Vidskiptaskilabod/>
<F22_1til4/>
<LinaC1/>
<LinaC2/>
<LinaC3/>
<LinaC4/>
<LinaD1/>
<LinaD2/>
<TegundAdgerd/>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID/>
</Kvittun>
</HeimildSkilabod>

4.5.3 - Error Codes

Error code Description
1 Web Service ID does not exist.
2 Wrong user name or password.
3 User (xxx) does not have access to Web Service (VefthjonustaID=yyy).
4 User name (xxx) does not have accesss to the Web Service (VefthjonustaID yyy) from IP no. zzz.
200 Contract number is missing.
201 The contract number must be 6 digits. A 0 may be used as the first digit.
202 Contract number x does not exist.
204 Contract number x is not associated with Icelandic SS number y.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
209 POS terminal ID is missing.
210 POS terminal ID must be in digits only.
219 Virtual card number is missing.
220 Virtual card number is void. Virtual card number is 16 digits where digits 2 through 9 are 99999.
221 Virtual card number does not exist.
222 The amount is missing.
223 The amount must be in digits.
224 The currency is missing.
225 The currency must be three letters.
226 Contract number x is not listed for currency y.
227 SS no. x does not have access to virtual card number y .
229 Failed to reimburse. Different messages can appear.
230 POS terminal ID x is not associated with SS no. y.
231 The card associated with virtual card number x has expired. The card ends in y.
235 Error: location of card holder is too short.
500 System error. (Different messages may appear)
900 Unknow error. (Different messages may appear)

We suggest that coding allows for the possibility that Web Services may return other error numbers than those listed in this document.

4.6 - UppfaeraGildistima

This function is used to update the expiration date (valid period) of a card associated with a virtual card number.

4.6.1. Definitions

4.6.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
SamningsKennitala N 10 10 M Contract's Icelandic SS no.
Syndarkortnumer N 16 16 M Virtual card number received from the function FaSyndarkortnumer.
NyrGildistimi N 4 4 M New expiration date.
Stillingar AN 1 250 O Additional paramters. Not currently in use.

4.6.1.2 - Response

Field Type Len. min Len. max Usage Description
Villuskilabod AN 1 16 M Error description. Is empty if there is no error.
Villunumer N 1 3 M Error number. Is 0 if no error. See table 4.4.3.
VilluLogID N 1 - M Error ID in Valitor logs.

4.6.2 - Examples

4.6.2.1 - Request example

<?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>
<UppfaeraGildistima xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala>
<Syndarkortnumer>4999993986001010</Syndarkortnumer>
<NyrGildistimi>0515</NyrGildistimi>
<Stillingar></Stillingar>
</UppfaeraGildistima>
</soap:Body> </soap:Envelope>

4.6.2.2 - Response example

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

4.6.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<Skilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>2</Villunumer>
<Villuskilabod>Rangt notandanafn eða lykilorð.</Villuskilabod>
<VilluLogID>0</VilluLogID>
</Skilabod>

4.6.3 - Error Codes

Error code Description
1 Web Service ID no. does not exist.
2 Wrong user name or password.
3 User name (xxx) does not have accesss to the Web Service (VefthjonustaID=yyy).
4 User name (xxx) does not have accesss to the Web Service (VefthjonustaID yyy) from IP no. zzz.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
214 Expiration date is missing.
215 Expiration date must be 4 digits.
219 Virtual card number is missing.
220 Virtual card number is void. Virtual card number is 16 digits where digits 2 through 9 are 99999.
221 Virtual card number does not exist.
227 SS no. x does not have access to virtual card number y .
999 Unknown error. (Different messages may appear.)

4.7 - FaSidustuFjoraIKortnumeriUtFraSyndarkortnumeri

This function is used to reveal the last four digits of the card associated with the virtual card number.

4.7.1 - Definitions

4.7.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
SamningsKennitala N 10 10 M Merchant's Icelandic SS no.
Syndarkortnumer N 16 16 M Virtual card no. received from the function FaSyndarkortnumer.
Stillingar AN 1 250 O Additional parameters. Not currently in use.

4.5.1.2 - Response

Field Type Len. min Len. max Usage Description
Villuskilabod AN 1 16 M Error description. Is empty if there is no error.
Villunumer N 1 3 M Error number. Is 0 if no eror. See Table 4.5.3.
VilluLogID N 1 - M Error ID in Valitor logs.

4.7.2 - Examples

4.7.2.1 - Request example

<?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>
<FaSidustuFjoraIKortnumeriUtFraSyndarkortnumeri xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala>
<Syndarkortnumer>4999993986001010</Syndarkortnumer>
<Stillingar></Stillingar>
</FaSidustuFjoraIKortnumeriUtFraSyndarkortnumeri>
</soap:Body> </soap:Envelope>

4.7.2.2 - Response example

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

4.7.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<KortnumerUtFraSyndarkortnumeriSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>2</Villunumer>
<Villuskilabod>Rangt notandanafn eða lykilorð.</Villuskilabod>
<VilluLogID>0</VilluLogID>
</KortnumerUtFraSyndarkortnumeriSkilabod>

4.7.3 - Error Codes

Error code Description
1 Web Service ID no. does not exist.
2 Wrong user name or password.
3 User name (xxx) does not have accesss to the Web Service (VefthjonustaID=yyy).
4 User name (xxx) does not have accesss to the Web Service (VefthjonustaID yyy) from IP no. zzz.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
214 Expiration date is missing.
215 Expiration date must be 4 digits.
219 Virtual card number is missing.
220 Virtual card number is void. Virtual card number is 16 digits where digits 2 through 9 are 99999.
221 Virtual card number does not exist.
227 SS no. x does not have access to virtual card number y .
230 Failure to update expiration date x.
500 System error. (Different messages may appear)
999 Unknow error. (Different messages may appear)

4.8 - FaOgildingu

4.8.1 - Definitions

This function is used to cancel a transaction that has already been processed using the FaHeimild function.

Cancellation is possible if the transaction has not been cleared. Clearing is done at the end of each day.

If clearing has already been performed, the function FaEndurgreitt is used to refund the cardholder.

4.8.1.1 - Request

Field Type Len. min Len. max Usage Description
Notandanafn AN 1 50 M Merchant's Web Service user name.
Lykilord AN 1 50 M Merchant's Web Service password.
Samningsnumer N 6 6 M Merchant's contract no.
SamningsKennitala N 10 10 M Contract's Icelandic SS no.
PosiID B 1 - M POS terminal ID received from Valitor.
Syndarkortnumer N 16 16 M Virtual card no. received from the function FaSyndarkortnumer.
Gjaldmidill AN 3 3 M Currency, e.g. ISK, USD, EUR, DKK.
Faerslunumer AN 6 6 M Transaction number of the transaction being cancelled. This is the value that is in Kvittun -> Faerslunumer when FaHeimild is used.
Stillingar AN 1 250 O Additional parameters. Not currently in use.

4.8.1.2 - Response

Field Type Len. min Len. max Usage Description
Villuskilabod AN 1 16 M Error description. Is empty if there is no error.
Villunumer N 1 3 M Error no. Is 0 if no error. See table in 4.3.3.
VilluLogID N 1 - M Error ID in Valitor logs
Kvittun/Receipts OB - - - Kvittun/Receipts object
4.8.1.2.1 - Receipts Response Object
Field Type Len. min Len. max Usage Description
 VerslunNafn AN 1 - M Name of store.
 VerslunHeimilisfang AN 1 - M Store address.
 VerslunStadur AN 1 - M Place of store.
 TegundKorts AN 1 - M Card type, e.g. VISA.
 TegundKortsKodi N 3 3 M Card type code.
Example:
400 (VISA)
500 (MasterCard)
530 (AMEX)
 Dagsetning AN 10 10 M Authorization date.
 Timi AN 1 - M Authorization time.
 Kortnumer AN 19 19 M Starred card no. where last 4 digits appear.
 Upphaed AN 19 19 M Amount.
 Faerslunumer N 5 5 M Transaction no.
 Faersluhirdir AN 19 19 M Acquirer name and phone no.
 Heimildarnumer N 6 6 M Authorization number.
 StadsetningNumer N 4 4 M Location no., default 0001.
 UtstodNumer N 4 4 M Terminal no., default 0001.
 BuidAdOgilda B - - M True if transaction canceled.
 Bunkanumer AN 8 8 M Batch numbers with prefix B.
 Soluadilinumer AN 8 8 M Merchant contract no. with prefix S.
 Hugbunadarnumer N 11 11 M Permanent no.: 11101020000.
 PosiID N 1 - M POS terminal ID allocated by Valitor.
 PinSkilabod - - - - Not used.
 Vidskiptaskilabod AN 1 - M Text, currency and amount.
 F22_1til4 N 4 4 M Permanent no.: 5101.
 LinaC1 N 3 3 M Permanent no.: 060.
 LinaC2 N 4 4 M Permanent no.: 1509.
 LinaC3 AN 1 - M Text and transaction no.
 LinaC4 AN 1 - M Text and authorization no.
 LinaD1 - - - - Not used.
 LinaD2 - - - - Not used.
 TegundAdgerd AN 11 11 M Standard text: OGILDA.
 FaerslunumerUpphafleguFaerslu - - - M Not in use.
 TerminalID N 8 8 M Terminal ID.

4.8.2 - Examples

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>
<FaOgildingu xmlns="http://api.valitor.is/Fyrirtaekjagreidslur/">
<Notandanafn>AbC123</Notandanafn>
<Lykilord>84jkf</Lykilord>
<Samningsnumer>60000</Samningsnumer>
<SamningsKennitala>2112683579</SamningsKennitala> <PosiID>1</PosiID>
<Syndarkortnumer>4999993986001010</Syndarkortnumer>
<Gjaldmidill>ISK</Gjaldmidill>
<Faerslunumer>213323</Faerslunumer>
<Stillingar></Stillingar>
</FaOgildingu>
</soap:Body> </soap:Envelope>

4.8.2.2 - Response

<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>0</Villunumer>
<Villuskilabod />
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn>123.is ehf</VerslunNafn>
<VerslunHeimilisfang>Pósthólf 12063</VerslunHeimilisfang>
<VerslunStadur>Reykjavik</VerslunStadur>
<TegundKorts>VISA</TegundKorts> <TegundKortsKodi>400</TegundKortsKodi>
<Dagsetning>14.05.2009</Dagsetning>
<Timi>09:38</Timi>
<Kortnumer>****-****-****-6987</Kortnumer>
<Upphaed>50</Upphaed>
<Faerslunumer>213327</Faerslunumer>
<Faersluhirdir>Valitor, sími: 525 2000</Faersluhirdir>
<Heimildarnumer>114355</Heimildarnumer>
<StadsetningNumer>0001</StadsetningNumer>
<UtstodNumer>0001</UtstodNumer>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer>469</Bunkanumer>
<Soluadilinumer>0039189</Soluadilinumer>
<Hugbunadarnumer>11101020000</Hugbunadarnumer>
<PosiID>0001</PosiID>
<PinSkilabod />
<Vidskiptaskilabod>VIÐSKIPTI ISK: 50</Vidskiptaskilabod>
<F22_1til4/>0000</F22_1til4>
<LinaC1>060</LinaC1>
<LinaC2>1509</LinaC2>
<LinaC3>FÆRSLUNR: 0000001</LinaC3>
<LinaC4>HEIMILD:114355</LinaC4>
<LinaD1 />
<LinaD2 />
<TegundAdgerd>ÓGILDING</TegundAdgerd>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID>11100004</TerminalID>
</Kvittun>
</HeimildSkilabod>

4.8.2.3 - Response error

<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<HeimildSkilabod xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns=" http://api.valitor.is/Fyrirtaekjagreidslur/">
<Villunumer>233</Villunumer>
<Villuskilabod>PosiID 89 tilheyrir ekki samningsnúmerinu 000122.</Villuskilabod>
<VilluLogID>0</VilluLogID>
<Kvittun>
<VerslunNafn/>
<VerslunHeimilisfang/>
<VerslunStadur/>
<TegundKorts/>
<Dagsetning/>
<Timi/>
<Kortnumer/>
<Upphaed/>
<Faerslunumer/>
<Faersluhirdir/>
<Heimildarnumer/>
<StadsetningNumer/>
<UtstodNumer/>
<BuidAdOgilda>false</BuidAdOgilda>
<Bunkanumer/>
<Soluadilinumer/>
<Hugbunadarnumer/>
<PosiID/>
<PinSkilabod/>
<Vidskiptaskilabod/>
<F22_1til4/>
<LinaC1/>
<LinaC2/>
<LinaC3/>
<LinaC4/>
<LinaD1/>
<LinaD2/>
<TegundAdgerd/>
<FaerslunumerUpphafleguFaerslu/>
<TerminalID/>
</Kvittun>
</HeimildSkilabod>

4.8.3 - Villur

Error Code Description
1 The web service id does not exist.
2 Wrong username or password.
3 The username (xxx) does not have access to the web service id (VefthjonustaID=yyy).
4 The username (xxx) does not have access to the web service (VefthjonustaID yyy) from the ip address zzz.
200 Contract number is missing.
201 The contract number must be 6 digits. A 0 may be used as the first digit.
202 Contract number x does not exist.
204 Contract number x is not associated with Icelandic SS number y.
205 The contract owner's Icelandic SS no. is missing.
206 The contract owner's Icelandic SS no. must be 10 digits.
207 The SS no. does not exist.
208 User name x does not have access to the contract associated with Icelandic SS no. y.
209 POS terminal ID is missing.
210 POS terminal ID must be in digits only.
219 Virtual card number is missing.
220 Virtual card number is void. Virtual card number is 16 digits where digits 2 through 9 are 99999.
221 Virtual card number does not exist.
225 The currency must be three letters.
226 Contract number x is not listed for currency y.
227 SS no. x does not have access to virtual card number y .
229 Failed to cancel. Different messages can appear.
230 POS terminal ID x is not associated with SS no. y.
231 The card associated with virtual card number x has expired. The card ends in y.
233 POS terminal ID x is not associated with contract number y.
500 System Error. (Different messages may appear))
999 Unknown Error. (Different messages may appear)

Við mælum með að gert sé ráð fyrir í kóða að vefþjónustur geti skilað öðrum villunúmerum en þeim sem eru upptalin í þessu skjali.