4 - Functions

4.1 - FramkvaemaAdgerd

4.1.1 - Input

Field	Type	Usage	Description
Notandanafn (User Name)	String	Required	User name for web services login.
Lykilord (Password)	String	Required	Password for access to web services.
PosId (PosID)	Integer	Required	ID number of web POS terminal to be used. This must be a number.
Adgerd (Operation)	String	Required	Specifies which operation is to be run on the POS terminal. A list of legal operations and the values they return can be found in Chapter 5.
Kortaupplysingar (CardInformation)	String	Required in: NETGREIDSLA SIMGREIDSLA OGILDA OGILDAENDURGREIDSLU ENDURGREIDSLA ADEINSHEIMILD	Card information must be in the following form: K-G Where K is the card number (from 13 to 19 characters) and G is the expiry date (YYMM). Example: 412341234123441234-1301 It is also possible to read Track2 with a magnetic stripe reader and send it in unchanged. Note that if you send information in Query String, you must change plus signs to minus signs.
SidustuFjorirIKortnumeri	-	Required in: OGILDAFAERSLU ENDURGREIDAFAERSLU	The last four characters of the card number. Required for operations EndurgreidaFaerslu (RefundTransaction) and OgildaFaerslu (CancelTransaction).
Oryggisnumer (VerificationCode)	String	Required in: NETGREIDSLA SIMGREIDSLA ADEINSHEIMILD	This is the CVV2/CCV2 code on the back of a credit card. Required when the card is used for Internet transactions.
ChipGogn (ChipData)	String	Required in:	Required if this is a Chip Card in use and authorisation must be obtained.
Faerslunumer (TransactionNumber)	Integer	Required in: SIMGREIDSLA KVITTUN OGILDA OGILDAENDURGREIDSLU OGILDAFAERSLU ENDURGREIDAFAERSLU EFTIRASKRANING	Number of the transaction for which the operation is run. Required for certain operations.
Upphaed (Amount)	Integer	Required in: NETGREIDSLA SIMGREIDSLA OGILDAENDURGREIDSLU ENDURGREIDSLA ENDURGREIDAFAERSLU MAILORDER ADEINSHEIMILD EFTIRASKRANING	A single decimal separator is allowed. Example: 100 = ISK 100 Example: 100.50 = EUR 100.50 (e.g. if the POS terminal is configured for Euros).
Stillingar (Settings)	String	Required in: NETGREIDSLA SIMGREIDSLA ENDURGREIDAFAERSLU ADEINSHEIMILD EFTIRASKRANING	Various settings. More than one can be configured. More information in the Settings table, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;)

4.1.1.1 - Settings - Stillingar table

Setting	Description
Gjaldmidill (Currency)	If a sale is transacted in a currency other than ISK, the ISO value for the currency must be specified. Sending in Gjaldmidill:352; is recommended for ISK if the merchant uses many ISO currency codes. Explanation (ISO - Currency): 124 - CAD (Canadian Dollar) 208 - DKK (Danish Krone) 352 - ISK (Icelandic Kronur) 578 - NOK (Norwegian Krone) 752 - SEK (Swedish Krona) 826 - GBP (British Pound) 840 - USD (US Dollar) 978 - EUR (Euro)
Flugbokunarnumer (FlightBookingNumber)	May be a 12-Character string
cavv	Cardholder Authentication Verification Value. A cryptogram representing the authentication itself.
xid	Valitor reference number for the authentication.
mdStatus	End status of the transaction. Possible values: 1 = Fully Authenticated, continue transaction 2,3,4 = Authentication attempt, possible to continue. 5 = Gray area, sometimes possible to continue Only if mdStatus is 1, 2, 3, 4 or 5 the merchant can attempt to pay with payment method.
dsTransId	A globally unique identifier (GUID) that represents the directory server transaction id, required when merchant is enrolled in 3DS2.x. Example : dstransid:780cb359-a562-496b-9644-73cf336c8636

4.1.2 - Output

Field	Type	Usage	Description
Villunumer (ErrorNumber)	Integer	Always returned	Returns an error number. Returns 0 if there is no error.
Villuskilabod (ErrorMessage)	String	Always returned	Further explanation of the error.
Faerslunumer (TransactionNumber)	String	Always returned	Unique transaction number.
EndurtekningarNumer (RepeatNumber)	String	Returned sometimes	Not used.
Heimildarsvar (AuthorisationResponse)	String	Returned in: NETGREIDSLA SIMGREIDSLA OGILDA OGILDAFAERSLU	Returns a response from the raw authorisation system in human readable form.
Heimildarnumer (AuthorisationNumber)	String	Returned in: NETGREIDSLA SIMGREIDSLA OGILDA OGILDAFAERSLU	Authorisation number for the transaction.
SvartimiSek (ResponseTimeSec)	Double	Always returned	Returns the response time in seconds.
Kortnumer (CardNumber)	String	Returned in: NETGREIDSLA SIMGREIDSLA OGILDA OGILDAENDURGREIDSLU OGILDAFAERSLU ENDURGREIDSLA ENDURGREIDAFAERSLU	Card number received by the system during the operation. First six and last four characters displayed.
Gildistimi (ExpiryDate)	String	Returned in: NETGREIDSLA SIMGREIDSLA OGILDA OGILDAFAERSLU	Expiry date of the card received by the system during the operation.
TegundKorts (CardType)	String	Returned sometimes	Returns three digit code for the type of card. Example: 240 - Domestic VISA Debit 250 - Domestic MasterCard Debit 260 - Landsbankinn Aukakrónur Card 400 - VISA 500 - MasterCard 530 - American Express
Kvittun (Receipt)	Object	Returned in: NETGREIDSLA SIMGREIDSLA KVITTUN OGILDA OGILDAENDURGREIDSLU OGILDAFAERSLU ENDURGREIDSLA ENDURGREIDAFAERSLU	Returns a receipt for the transaction, see the included fields.
FaersluListi (TransactionList)	Object	Returned sometimes	List of unsettled transactions in the POS terminal.
Heildarlisti (CompleteList)	Object	Returned sometimes	Complete list of settled transactions in the POS terminal.

4.1.2.1 - Receipt - Kvittun Object

The Receipt (Kvittun) object returns a receipt for the transaction, see the included fields.

Field	Type	Usage	Description
VerslunNafn (StoreName)	String	Always returned	Name of the store (Doing Business As).
VerslunHeimilisfang (StoreAddress)	String	Always returned	Address of the store.
VerslunStadur (StoreCity)	String	Always returned	City/town where store is located.
TegundKorts (CardType)	String	Always returned	Returns the type of card where appropriate. Example: VISA, Mastercard, Amex.
Dagsetning (Date)	String	Always returned	Date of the transaction.
Time (Time)	String	Always returned	Time of the transaction.
Kortnumer (CardNumber)	String	Always returned	First six and last four characters in the card number on the card used.
KortnumerObrenglad (CardNumberUnencrypted)	String	Always returned	First six and last four characters in the card number on the card used.
Upphaed (Amount)	String	Always returned	Transaction amount.
Gjaldmidill (Currency)	String	Always returned	Three letter abbreviation for currency of transaction. Example: ISK.
Faerslunumer (TransactionNumber)	String	Always returned	Unique transaction number.
Faersluhirðir (Acquirer)	String	Always returned	Name and telephone number of acquirer.
Heimildarnumer (AuthorisationNumber)	String	Always returned	Authorisation number of the transaction.
StadsetningNumer (LocationNumber)	String	Always returned	Store number. Must be displayed on the receipt immediately above the UtstodNumer (TerminalNumber).
UtstodNumer (TerminalNumber)	String	Always returned	Number of the terminal within the store. Must be displayed on the receipt immediately after the StadsetningNumer (LocationNumber).
BuidAdOgilda (IsCancelled)	String	Always returned	Indicates whether the transaction has been cancelled.
Bunkanumer (BatchNumber)	String	Always returned	Batch number NOTE: batches are renewed daily.
Soluadilanumer (MerchantNumber)	String	Always returned	Number of agreement with Valitor(VISA, MC and AMEX).
Hugbunadarnumer (SoftwareNumber)	String	Always returned	Software version.
PosiId (PosID)	String	Always returned	ID number of the POS terminal.
PinSkilabod (PINMessage)	String	Returned sometimes	Only returned if PIN was used. Can be PIN VERIFIED, PIN OK or PIN STADFEST. Indicates whether the PIN was confirmed in the Chip POS terminal.
Vidskiptaskilabod (SalesMessage)	String	Always returned	Text that must be displayed on the receipt. Example: SALE ISK: 100.
F22_1til4 (F22_1to4)	String	Always returned	Text that must be displayed on the receipt.
LinaC1 (LineC1)	String	Always returned	Character 1: Was the card present or not? Character 2: How was the data entered? Character 3: How was the purchaser identified?
LinaC2 (LineC2)	String	Always returned	Message Reason Code.
LinaC3 (LineC3)	String	Always returned	Transaction number in the authorisation system. This is a 7-digit number that always starts with 0. This is returned as a Faerslunumer í Bunkavefþjónustu VALITOR (Transaction Number in VALITOR's Batch Web Service) by the function SkilaKreditkortafaerslumUrBunka which returns credit card transactions from batch. NOTE: This is NOT the same transaction number used as an input parameter in Payment Service, for example for refunds or cancellations.
LinaC4 (LineC4)	String	Always returned	Authorisation number.
LinaD1 (LineD1)	String	Returned sometimes	Chip field.
LinaD2 (LineD2)	String	Returned sometimes	Chip field.
TegundAdgerd (OperationType)	String	Always returned	Indicates the type of operation implemented – web payment, phone payment, cancellation, refund.
FaerslunumerUpphafleguFaerslu (TransactionNumberOfOriginalTransaction)	String	Returned sometimes	Returned when cancelling a transaction.
TerminalID (TerminalID)	String	Always returned	ID of equipment in FGM system.

4.1.2.2 - TransactionList - FaersluListi Object

The Transaction List (Faerslulisti) object is a list of unsettled transactions in the POS terminal. See fields.

Field	Type	Usage	Description
VerslunNafn (StoreName)	String	Always returned	Name of the store (Doing Business As).
VerslunHeimilisfang (StoreAddress)	String	Always returned	Address of the store.
VerslunStadur (StoreCity)	Integer	Always returned	City/town where store is located.
VerslunNumer (StoreNumber)	String	Always returned	Store number.
UtstodNumer (TerminalNumber)	String	Always returned	Number of the terminal within the store.
BunkiNumer (BatchNumber)	String	Always returned	Batch number.
Samningsnumer (AgreementNumber)	String	Always returned	Agreement number with VISA and MasterCard, hyphen between.
TimabilFra (PeriodFrom)	String	Always returned	Start of transactions period.
TimabilTil (PeriodTo)	String	Always returned	End of transactions period.
Faerslur (Transactions)	Object	Always returned	Faerslur contain Faersla (transaction), see table

4.1.2.2.1 - Transaction - Faersla object

The Transactions (Faerslur) object only includes Transaction (Faersla) objects. See fields.

Field	Type	Usage	Description
FaersluTegund (TransactionType)	String	Always returned	Specifies the type of transaction.
FaersluTegundId (TransactionTypeID)	String	Always returned	Number that identifies the type of transaction.
KortaTegund (TypeOfCard)	String	Always returned	See TegundKorts (CardType) above.
Upphaed (Amount)	Integer	Always returned	Transaction amount in ISK.
Dagsetning (Date)	String	Always returned	Date of the transaction.
Faerslunumer (TransactionNumber)	String	Always returned	Unique transaction number.
Kortnumer (CardNumber)	String	Always returned	Last four digits of card number used to make the transaction.
Heimildarnumer (AuthorisationNumber)	String	Always returned	Authorisation number for the transaction.
Tilvisunarnumer (Reference number)	String	Always returned	Reference number for the transaction.
HefurVeridOgild (Already voided/cancelled)	String	Always returned	Indicates whether or not transaction has been cancelled/voided.

4.1.2.3 - CompleteList - Heildarlisti Object

The Complete List (Heildarlisti) object returns a complete list of settled transactions in the POS terminal. It contains two objects, see fields.

Field	Type	Usage	Description
VerslunNafn (StoreName)	String	Always returned	Name of the store (Doing Business As).
VerslunHeimilisfang (StoreAddress)	String	Always returned	Address of the store.
VerslunStadur (StoreCity)	String	Always returned	City/town where store is located.
VerslunNumer (StoreNumber)	String	Always returned	Store number.
UtstodNumer (TerminalNumber)	String	Always returned	Number of the terminal within the store.
BunkiNumer (BatchNumber)	Integer	Always returned	Batch number.
Samningsnumer (AgreementNumber)	String	Always returned	Agreement number with VISA and MasterCard, hyphen between.
TimabilFra (PeriodFrom)	String	Always returned	Start of transactions period.
TimabilTil (PeriodTo)	String	Always returned	End of transactions period.
KortaTegund (Card Type)	Object	Always returned	Object that includes Card Type Settlement (See table)
Faerslur (Transactions)	Object	Always returned	Object that includes Transaction Order (See table)

4.1.2.3.1 - CardTypeSettlement - KortaTegundUppgjor Object

The Card Type (KortaTegund) object only includes Card Type Settlement (KortaTegundUppgjor) objects. See fields.

Field	Type	Usage	Description
KortaTegundNafn (TypeOfCardName)	String	Always returned	Name of the card type, e.g. VISA, MC, AMEX.
KortategundTala (CardTypeNumber)	Integer	Always returned	Card type ID using unique number.

4.1.2.3.2 - TransactionOrder - FaersluRod Object

The Transactions (Faerslur) object only contains Transaction Order (FaersluRod) objects. See fields.

Field	Type	Usage	Description
Tegund (Type)	String	Always returned	Type of transaction. Can be "Sale", "Refund", "Cancellation" or "Refund cancellation".
FaerslurFjoldi (TransactionCount)	Integer	Always returned	Number of transactions of this type.
FaerslurUpphaed (TransactionsTotal)	Integer	Always returned	Total amount of all transactions of this type.
SamtalsFjoldi (TotalCount)	Integer	Always returned	Total number of transactions in the settlement for this card type.
SamtalsKronur (TotalKronur)	Integer	Always returned	Total amount in ISK for all transactions for this card type.
SamtalsSalaFjoldi (TotalSalesCount)	Integer	Always returned	Total number of transactions of type "Sala" (Sale) for all card types.
SamtalsSala (TotalSales)	Integer	Always returned	Total sales amount in ISK for all transactions of the type "Sala" (Sale).
SamtalsEndurgreidslaFjoldi (TotalRefundCount)	Integer	Always returned	Total number of transactions of type "Endurgreidsla" (Refund) for all card types.
SamtalsEndurgreidsla (TotalRefunds)	Integer	Always returned	Total amount for all transactions of the type "Endurgreidsla" (Refund).
SamtalsOgiltarEndurgreidslurFjoldi	Integer	Always returned	Total number of transactions of type "Ógild endurgreidsla" (Cancelled refund) for all card types.
SamtalsOgiltarEndurgreidslur	Integer	Always returned	Total amount for all transactions of the type "Ógild endurgreidsla" (Cancelled refund).
SamtalsOgildaFjoldi (TotalCancellationsCount)	Integer	Always returned	Total number of transactions of type "Ógilding" (Cancellation) for all card types.
SamtalsOgilda (TotalCancellations)	Integer	Always returned	Total amount for all transactions of the type "Ógilding" (Cancellation).
SamtalsSamtals (GrandTotal)	Integer	Always returned	Total amount of all transactions of all types.

4.1.3 - Receipt example

XML

<Kvittun>
<VerslunNafn>123.is ehf.</VerslunNafn>
<VerslunHeimilisfang>Pósthólf 12063</VerslunHeimilisfang>
<VerslunStadur>Reykjavik</VerslunStadur>
<TegundKorts>VISA</TegundKorts>
<Dagsetning>14.05.2009</Dagsetning>
<Timi>09:38</Timi>
<Kortnumer>452212******6987</Kortnumer>
<KortnumerObrenglad>4522-12**-****-6987</KortnumerObrenglad>
<Upphaed>100</Upphaed>
<Gjaldmidill>ISK</Gjaldmidill>
<Faerslunumer>26711</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: 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>NETGREIÐSLA</TegundAdgerd>
<FaerslunumerUpphafleguFaerslu />
<TerminalID>11100004</TerminalID>
</Kvittun>

4.1.4 - Usage Example

Call to function FramkvaemaAdgerd (ImplementOperation):
https://paymentservice.uat.valitor.com/greidslugatt.asmx?op=FramkvaemaAdgerd

Example of net payment of more than EUR 100:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	1
Adgerd (Operation)	NETGREIDSLA
Kortaupplysingar (CardInformation)	9999999999999999-1411 (NOTE: Expiry date is YYMM)
Oryggisnumer (VerificationCode)	123
Chipgogn (ChipData)
Faerslunumer (TransactionNumber)
Upphaed (Amount)	100
Stillingar (Settings)	Gjaldmidill:978;

Example of a net payment for ISK 100:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	1
Adgerd (Operation)	NETGREIDSLA
Kortaupplysingar (CardInformation)	9999999999999999-1411 (NOTE: Expiry date is YYMM)
Oryggisnumer (VerificationCode)	123
Chipgogn (ChipData)
Faerslunumer (TransactionNumber)
Upphaed (Amount)	100
Stillingar (Settings)

Info

Gjaldmidill:352; is a valid entry for Stillingar if a sale is transacted in ISK.
This action is recommended if a merchant has another agreement in a foreign currency.

4.2 - FaListaYfirMogulegarOgildingar (GetListOfPossibleCancellations)

4.2.1 - Input

Field	Type	Usage	Description
Notandanafn (UserName)	String	Required	User name for web services login.
Lykilord (Password)	String	Required	Password for access to web services.
PosId (PosID)	Integer	Required	ID number of web POS terminal to be used. This must be a number.
Kortaupplysingar (CardInformation)	Integer	Required sometimes	Card information must be in the following form: K-G. Where K is the card number (from 13 to 19 characters) and G is the expiry date (YYMM). Example: 412341234123441234-1301

4.2.2 - Output

Field	Type	Usage	Description
Villunumer (ErrorNumber)	Integer	Always returned	Returns an error number. Returns 0 if there is no error.
Villuskilabod (ErrorMessage)	String	Always returned	Further explanation of the error.
FjoldiFaerslna (Number of transactions)	Integer	Always returned	Number of transactions that can be cancelled/voided.
Faerslur (Transactions)	Object	Always returned	Object that includes OgildaFaersla object (see table)

4.2.2.1 - OgildaFaersla Object

The Transactions (Faerslur) object only contains OgildaFaersla objects. See fields.

Field	Type	Usage	Description
Faerslunumer (TransactionNumber)	Long	Always returned	Unique transaction number.
Kortnumer (CardNumber)	String	Always returned	Card number on the card used.
Upphaed (Amount)	Integer	Always returned	Transaction amount.
Dagsetning (Transaction date)	String	Always returned	Date of transaction.
FaersluNumerXps	Integer	Always returned	Unique transaction number in XPS system.

4.2.3 - Errors

Number	Description
237	Could not get number of open batches.
238	No batch open and therefore no transactions that can be cancelled/voided.
239	Could not retrieve batch.

4.2.4 - Usage Example

Call to function FaListaYfirMogulegarOgildingar (GetListOverPossibleCancellations):
https://paymentservice.uat.valitor.com/greidslugatt.asmx?op=FaListaYfirMogulegarOgildingar

Example:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	1
Kortaupplysingar (CardInformation)	9999999999999999-1411 (NOTE: Expiry date is YYMM)

4.3 - DccTilbod

Creates a DCC offer in card currency against the merchant currency. The offer can then be accepted with the function DccHeimild.

4.3.1 - Input

Field	Type	Usage	Description
Notandanafn	String	Required	User name for web services login
Lykilord	String	Required	Password for access to web services
PosiId	Integer	Required	ID number of web POS terminal to be used. This must be a number.
Kortaupplysingar	String	Required	Card information must be in the following form: K Where K is the card number (from 13 to 19 characters). Example: 412341234123441234
Upphaed	Integer	Required	A single decimal separator is allowed. Example: 100 = ISK 100 100.50 = EUR 100.50 (e.g. if the POS terminal is configured for Euros).

4.3.2 - Output

Field	Type	Usage	Description
Villunumer	Integer	Always returned	Returns an error number. Returns 0 if there is no error.
Villuskilabod	String	Always returned	Further explanation of the error.
Faerslunumer	Integer	Returned sometimes	Valitor offer ID, this is to be used when accepting and authorizing the offer.
Gjaldmidill	String	Returned sometimes	Merchant currency.
Upphaed	Integer	Returned sometimes	Amount in merchant currency
GjaldmidillTilbods	String	Returned sometimes	Card currency
UpphaedTilbods	Integer	Returned sometimes	Amount + DCC fee, in card currency
UpphaedGjalds	Integer	Returned sometimes	DCC fee in card currency
Gengi	Integer	Returned sometimes	Exchange rate
Heimildarsvar	Integer	Returned sometimes	Returns a response from the raw authorisation system in human readable form.

4.3.3 - Errors

Error Code	Description
201	Card number must be at least 11 digits. / Card number may not be longer than 19 characters.
206	Amount must be more than 0.
208	Communication error, please try again.
211	Not allowed to accept this type of card.
212	Incorrect card number format.
213	Not allowed to accept this type of card.
236	Card number missing.
247	DCC Transaction not allowed to Cardholder
248	DCC Cardholder currency not supported
249	DCC Exceeds time limit for withdrawal (too late)
251	DCC Transaction not allowed to terminal equipment
252	DCC not allowed to merchant
253	DCC not allowed for this PosId

4.3.4 - Usage Example

Call to function DccTilbod (DccOffer):
https://paymentservice.uat.valitor.com/greidslugatt.asmx?op=DccTilbod

Example:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	1
Kortaupplysingar (CardInformation)	9999999999999999
Upphaed (Amount)	100

4.4 - DccHeimild

Approves DCC offer and charges the card based on the offer.

4.4.1 - Input

Field	Type	Usage	Description
Notandanafn	String	Required	User name for web services login
Lykilord	String	Required	Password for access to web services
PosiId	Integer	Required	ID number of web POS terminal to be used. This must be a number.
DccFaerslunumer	Integer	Required	Id of the DCC offer to be used. The id is from the function DccTilbod
Kortaupplysingar	String	Required	Card information must be in the following form: K-G Where K is the card number (from 13 to 19 characters) and G is the expiry date (YYMM). Example: 412341234123441234-1301 It is also possible to read Track2 with a magnetic stripe reader and send it in unchanged. Note that if you send information in Query String, you must change plus signs to minus signs.
Oryggisnumer	Integer	Required	This is the CVV2/CCV2 code on the back of a credit card. Required when the card is used for Internet transactions.

4.4.2 - Output

Same values as in FramkvaemaAdgerd plus the following fields, that are specific to DCC transaction.

Field	Type	Usage	Description
GjaldmidillSoliadila	String	Always returned	Merchant currency
DccGjald	Double	Always returned	DCC fee in card currency
Gengi	Integer	Always returned	Exchange rate.

4.4.3 - Errors

Error Code	Description
208	Communication error, please try again.
203	Missing verification code (CVV2/CVC2).
210	Verification code (CVV2/CVC2) too long.
217	Expiry date incorrectly formatted.
247	DCC Transaction not allowed to Cardholder
248	DCC Cardholder currency not supported
251	DCC Transaction not allowed to terminal equipment
252	DCC not allowed to merchant
253	DCC not allowed for this PosId
254	DccFærslunúmer is not a valid DCC offer.
256	Card number does not match the offer cardnumber.
257	This offer has already been accepted and authorized
258	DCC offer expired. Note that the offer is valid for 20 minutes.
259	PosId does not match with offer posId

4.4.4 - Usage Example

Call to function DccHeimild:
https://paymentservice.uat.valitor.com/greidslugatt.asmx?op=DccHeimild

Example:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	237
DccFaerslunumer (DccTransactionNumber)	123456
Kortaupplysingar (CardInformation)	9999999999999999-1411 (NOTE: Expiry date is YYMM)
Oryggisnumer (VerificationCode)	123

4.5 - Audkenning

Authenticates cardholder with 3DSecure and sends merchant a HTML form to authorize the transaction.

4.5.1 - Input

Field	Type	Usage	Description
Notandanafn	String	Required	User name for web services login
Lykilord	String	Required	Password for access to web services
PosiId	Integer	Required	ID number of web POS terminal to be used. This must be a number.
Kortaupplysingar	String	Required	Card information must be in the following form: K-G Where K is the card number (from 13 to 19 characters) and G is the expiry date (YYMM). Example: 412341234123441234-1301 It is also possible to read Track2 with a magnetic stripe reader and send it in unchanged. Note that if you send information in Query String, you must change plus signs to minus signs.
Upphaed	Integer	Required	A single decimal separator is allowed. Example: 100 = ISK 100 100.50 = EUR 100.50 (e.g. if the POS terminal is configured for Euros).
AudkenningTokstUrl	String	Required	Valid web path that points to the site you want your users to redirect to when 3DSecure payment is authorized. Can be HTTP or HTTPS.
AudkenningMistokstUrl	String	Required	Valid web path that points to the site you want your users to redirect to when 3DSecure payment is not authorized. Can be HTTP or HTTPS.
SessionId	String	Optional	User can use this to send his web session ID between requests.
Stillingar (Settings)	String	Optional	Various settings. More than one can be configured. More information in the Settings table, for example: stilling1:123;stilling2:123abc;)

4.5.1.1 - Stillingar Tafla

Stilling

Lýsing

Exponent

Method to override number of decimal digits for request amount

Example:
exponent:0 (Currency exponent will be sent to the card issuer as 0)
exponent:2 (Currency exponent will be sent to the card issuer as 2).

When using ISK as the currency the exponent can be either 0 or 2. This is due to inconsistencies in the exponent expected by the issuer.
If the exponent was incorrect, the error is not visible until the callback response is received in AudkenningMistokstUrl.
This particular error has occurred when the MdStatus is either 5 or 6.
In this case, it is recommended to re-send the Audkenning request with the other exponent ie. if 0 was sent in the first attempt, re-send with an exponent of 2 (if exponent was sent empty in the first attempt use 2 for the second attempt).

4.5.2 - Output

Field	Type	Usage	Description
Villunumer	Integer	Always returned	Returns an error number. Returns 0 if there is no error.
Villuskilabod	String	Always returned	Further explanation of the error.
3dSecureResponse	String	Returned sometimes	HTML document that contains a payment form for 3DSecure.

4.5.3 - Errors

Number	Description
203	Missing verification code (CVV2/CVC2).
210	Verification code (CVV2/CVC2) too long.
217	Expiry date incorrectly formatted.
201	Card number must be at least 11 digits. / Card number may not be longer than 19 characters.
206	Amount must be more than 0.
211	Not allowed to accept this type of card.
212	Incorrect card number format.
213	Not allowed to accept this type of card.
236	Card number missing.
260	"AudkenningTokstUrl" or "AudkenningMistokstUrl" is not a valid web path.
261	POS device does not support 3dSecure.
262	Card type does not support 3dSecure.
263	POS device does not support 3dSecure against VISA.
264	POS device does not support 3dSecure against MasterCard.

4.5.4 - Usage Example

Call to function ThreeDSecureAudkenning:
https://paymentservice.uat.valitor.com/greidslugatt.asmx?op=Audkenning

Example:

Field	Value
Notandanafn (UserName)	visatest
Lykilord (Password)	visatest123
PosiId (PosID)	237
Kortaupplysingar (CardInformation)	9999999999999999-1411 (NOTE: Expiry date is YYMM)
Upphaed (Amount)	100
AudkenningTokstUrl	http://your-page.com/Success
AudkenningMistokstUrl	http://your-page.com/Failed
SessionId	123