5 - Operations
The function FramkvaemaAdgerd (ImplementOperation) can be used in various ways.
This chapter is to better explain the operations available in the function and how they're used.
5.1 - Summary of operations
NETGREIDSLA (ONLINEPAYMENT)
Sale where the cardholder is not present with the card during a sale over the Internet.
SIMGREIDSLA (TELEPHONEPAYMENT)
Sale where the cardholder is not present with the card during a sale by telephone.
KVITTUN (RECEIPT)
Returns a receipt for a particular transaction.
OGILDA (CANCEL)
Cancels a previously granted authorisation.
Cannot be used after a batch has been closed – in that case, use ENDURGREIDSLA (REFUND).
OGILDAENDURGREIDSLU (CANCELREFUND)
Cancels a refund in a batch which has not been closed.
OGILDAFAERSLU (CANCELTRANSACTION)
Cancels a previously granted authorisation by transaction number.
Cannot be used after a batch has been closed – in that case, use ENDURGREIDSLA (REFUND).
Useful for those who do not store card numbers in their database and cannot use the OGILDA (CANCEL) operation.
ENDURGREIDSLA (REFUND)
Refunds a specified amount to a specified card.
Please note that refunds can't be made on debit cards.
ENDURGREIDAFAERSLU (REFUNDTRANSACTION)
Refunds a specified amount with reference to a specified transaction number.
Checks if a refund has been made for the specified transaction number and does not make a refund if an attempt is made to repay a higher amount than that made during the original transaction.
Useful for those who do not store card numbers in their database and cannot use the ENDURGREIDSLA (REFUND) operation.
Please note that refunds can't be made on debit cards.
UPPGJOR (SETTLEMENT)
Closes the current batch in the POS terminal.
A new batch will be created with the next transaction.
If this operation is not called, the batch will be closed once a day and the transactions will be sent for settlement.
FAERSLULISTI (TRANSACTIONLIST)
List of unsettled transactions in the POS terminal.
HEILDARLISTI (COMPLETELIST)
List of all unsettled transactions in POS terminals itemised according to card type.
MAILORDER
Sale where the cardholder is not present with the card during a sale by mail.
ADEINSHEIMILD
PreAuthorization with amount larger than 0 specified.
Authorization is reserved from the card until you confirm it with the EFTIRASKRANING (confirmation) operation.
ADEINSHEIMILD with 0 amount is processed as a card check, it can be used to verify the card being used is valid.
EFTIRASKRANING
Confirms an already existing PreAuthorization and changes it into a fully valid internet sale.
5.2 - Operations
5.2.1 - Netgreidsla - Online Payment
This operation is used as NETGREIDSLA (Icelandic for Online Payment).
Sale where the cardholder is not present with the card during a sale over the Internet.
5.2.1.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is NETGREIDSLA. |
| Kortaupplysingar | String | 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-1301It 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 | String | This is the CVV2/CCV2 code on the back of a credit card. Required when the card is used for Internet transactions. |
| Upphaed | Integer | 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). |
| Stillingar | String | Various settings. Settings can be found in the settings table. More than one can be configured, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;) |
5.2.1.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.1.3 - Error codes
| Error Code | Description |
|---|---|
| 201 | Card number must be at least 11 digits. / Card number may not be longer than 19 characters. |
| 203 | Missing verification code (CVV2/CVC2). |
| 206 | Amount must be more than 0. |
| 207 | Authorisation failed. |
| 208 | Communication error, please try again. |
| 210 | Verification code (CVV2/CVC2) too long. |
| 211 | Not allowed to accept this type of card. |
| 212 | Incorrect card number format. |
| 213 | Not allowed to accept this type of card. |
| 214 | Authorisation system returned incorrect response. |
| 217 | Expiry date incorrectly formatted. |
| 227 | Attempt to charge in currency x, but merchant agreement is in y. |
| 236 | Card number missing. |
5.2.2 - Simgreidsla - Telephone Payment
This operation is used as SIMGREIDSLA (Icelandic for Telephone Payment).
Sale where the cardholder is not present with the card during a sale by telephone.
Attention
Oryggisnumer (VerificationCode) is now mandatory with this operation from 16.October 2020.
5.2.2.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is SIMGREIDSLA. |
| Kortaupplysingar | String | 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-1301It 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 | String | This is the CVV2/CCV2 code on the back of a credit card. Required when the card is used for Internet transactions. |
| Upphaed | Integer | 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). |
| Stillingar | String | Various settings. Settings can be found in the settings table. More than one can be configured, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;) |
5.2.2.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.2.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Card number must be at least 11 digits. / Card number may not be longer than 19 characters. |
| 203 | Missing verification code (CVV2/CVC2). |
| 206 | Amount must be more than 0. |
| 207 | Authorisation failed. |
| 208 | Communication error, please try again. |
| 210 | Verification code (CVV2/CVC2) too long. |
| 211 | Not allowed to accept this type of card. |
| 212 | Incorrect card number format. |
| 213 | Not allowed to accept this type of card. |
| 214 | Authorisation system returned incorrect response. |
| 215 | Call manually to request authorisation. |
| 217 | Expiry date incorrectly formatted. |
| 227 | Attempt to charge in currency x, but merchant agreement is in y. |
| 236 | Card number missing. |
5.2.3 - Kvittun - Receipt
This operation is used as KVITTUN (Icelandic for Receipt).
Returns a receipt for a particular transaction.
5.2.3.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is KVITTUN. |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
5.2.3.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.3.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Transaction not found. |
| 202 | Could not retreive transaction. |
| 203 | Could not retrieve original transaction. |
5.2.4 - Ogilda - Cancel
This operation is used as OGILDA (Icelandic for Cancel).
Cancels a previously granted authorisation.
Cannot be used after a batch has been closed – in that case, use ENDURGREIDSLA (REFUND).
5.2.4.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is OGILDA. |
| Kortaupplysingar | String | 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-1301It 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. |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
5.2.4.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.4.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Transaction not found. Note that it is not possible to cancel a transaction in a batch that has been closed. |
| 202 | No response from XPS system. |
| 203 | This transaction has been cancelled already. |
| 204 | Card number and expiry date do not correspond with transaction. |
| 208 | Communication error, please try again. |
| 234 | No authorization request paired with transaction. |
| 235 | Unable to cancel transaction. |
| 236 | Card number missing. |
| 243 | Not possible to cancel transaction from another acquirer. |
5.2.5 - Ogilda Endurgreidslu - Cancel Refund
This operation is used as OGILDAENDURGREIDSLU (Icelandic for Cancel Refund).
Cancels a refund in a batch which has not been closed.
5.2.5.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is OGILDAENDURGREIDSLU. |
| Kortaupplysingar | String | 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-1301It 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. |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
| Upphaed | Integer | 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). |
5.2.5.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.5.3 - Error Codes
| Error Code | Description |
|---|---|
| 203 | This transaction has been cancelled already. |
| 211 | Not allowed to accept this type of card. |
| 212 | Incorrect card number format. |
| 213 | Not allowed to accept this type of card. |
| 217 | Expiry date incorrectly formatted. |
| 231 | Could not find transaction with the given transaction number. |
| 232 | Transaction is not a refund. |
| 233 | Amount does not match the amount of the original refund. |
5.2.6 - Ogilda Faerslu - Cancel Transaction
This operation is used as OGILDAFAERSLU (Icelandic for Cancel Transaction).
Cancels a previously granted authorisation by transaction number.
Cannot be used after a batch has been closed – in that case, use ENDURGREIDSLA (REFUND).
Useful for those who do not store card numbers in their database and cannot use the OGILDA (CANCEL) operation.
5.2.6.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is OGILDAFAERSLU. |
| SidustuFjorirIKortnumeri | The last four characters of the card number. Required for operations EndurgreidaFaerslu (RefundTransaction) and OgildaFaerslu (CancelTransaction). | |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
5.2.6.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.6.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Transaction not found. Note that it is not possible to cancel a transaction in a batch that has been closed. |
| 202 | No response from XPS system. |
| 203 | This transaction has been cancelled already. |
| 204 | Card number and expiry date do not correspond with transaction. |
| 208 | Communication error, please try again. |
| 223 | Last four characters in card number do not match with transaction. |
| 234 | No authorization request paired with transaction. |
| 235 | Unable to cancel transaction. |
| 236 | Card number missing. |
| 240 | Last four characters in card number are missing or are not of the right length. |
| 243 | Not possible to cancel transaction from another acquirer. |
5.2.7 - Endurgreidsla - Refund
This operation is used as ENDURGREIDSLA (Icelandic for Refund).
Refunds a specified amount to a specified card.
5.2.7.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is ENDURGREIDSLA. |
| Kortaupplysingar | String | 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-1301It 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 | 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). |
5.2.7.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.7.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Not possible to pay refund to domestic debit card. |
| 202 | Card number must be at least 11 digits. / Card number may not be longer than 19 characters. |
| 208 | Amount must be more than 0. |
| 211 | Not allowed to accept this type of card. |
| 212 | Incorrect card number format. |
| 217 | Expiry date incorrectly formatted. |
| 230 | Card has expired. |
| 236 | Card number missing. |
5.2.8 - Endurgreida Faerslu - Refund Transaction
This operation is used as ENDURGREIDAFAERSLU (Icelandic for Refund Transaction).
Refunds a specified amount with reference to a specified transaction number.
Checks if a refund has been made for the specified transaction number and does not make a refund if an attempt is made to repay a higher amount than that made during the original transaction.
Useful for those who do not store card numbers in their database and cannot use the ENDURGREIDSLA (REFUND) operation.
5.2.8.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is ENDURGREIDAFAERSLU. |
| SidustuFjorirIKortnumeri | The last four characters of the card number. Required for operations EndurgreidaFaerslu (RefundTransaction) and OgildaFaerslu (CancelTransaction). | |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
| Upphaed | Integer | 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). |
| Stillingar | String | Various settings. Settings can be found in the settings table. More than one can be configured, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;) |
5.2.8.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.8.3 - Error Codes
| Error Code | Description |
|---|---|
| 208 | Amount must be more than 0. |
| 211 | Not allowed to accept this type of card. |
| 221 | Could not retrieve message using transaction number. |
| 222 | Transaction and POS terminal are incompatible. |
| 223 | Last four characters in card number do not match with transaction. |
| 224 | The refund amount is more than the original amount. |
| 225 | Not able to retrieve refunds for respective transaction number. |
| 226 | The total of previous refunds for this transaction number and the total of the current refund are more than the transaction amount. |
| 229 | Authorisation for that transaction number not found. |
| 230 | Card has expired. |
| 240 | Last four characters in card number are missing or are not of the right length. |
5.2.9 - Uppgjor - Settlement
This operation is used as UPPGJOR (Icelandic for Settlement).
Closes the current batch in the POS terminal. A new batch will be created with the next transaction. If this operation is not called, the batch will be closed once a day and the transactions will be sent for settlement.
5.2.9.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is UPPGJOR. |
5.2.9.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.9.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | No open batch to close. |
5.2.10 - Faerslulisti - Transaction List
This operation is used as FAERSLULISTI (Icelandic for Transaction List).
List of unsettled transactions in the POS terminal.
5.2.10.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is FAERSLULISTI. |
5.2.10.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.10.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | No open batch, empty list. |
| 228 | Failed to retrieve message batch. |
5.2.11 - Heildarlisti - Complete List
This operation is used as HEILDARLISTI (Icelandic for Complete List).
List of all unsettled transactions in POS terminals itemised according to card type.
5.2.11.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is HEILDARLISTI. |
5.2.11.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.11.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | No open batch, empty list. |
5.2.12 - Mail Order
This operation is used as MAILORDER.
Sale where the cardholder is not present with the card during a sale by mail. Oryggisnumer is not required.
5.2.12.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is MAILORDER. |
| Kortaupplysingar | String | 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-1301It 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 | 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). |
5.2.12.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.12.3 - Error Codes
| 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. |
| 207 | Authorisation failed. |
| 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. |
| 214 | Authorisation system returned incorrect response. |
| 215 | Call manually to request authorisation. |
| 217 | Expiry date incorrectly formatted. |
| 227 | Attempt to charge in currency x, but merchant agreement is in y. |
| 236 | Card number missing. |
5.2.13 - Adeins Heimild - Authorization Only
PreAuthorization with amount larger than 0 specified. Authorization is reserved from the card until you confirm it with the EFTIRASKRANING (confirmation) operation. ADEINSHEIMILD with 0 amount is processed as a card check, it can be used to verify the card being used is valid.
5.2.13.1 - Required Input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is ADEINSHEIMILD. |
| Kortaupplysingar | String | 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-1301It 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 | String | This is the CVV2/CCV2 code on the back of a credit card. Required when the card is used for Internet transactions. |
| Upphaed | Integer | 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). |
| Stillingar | String | Various settings. Settings can be found in the settings table. More than one can be configured, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;) |
5.2.13.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.13.3 - Error Codes
| Error Code | Description |
|---|---|
| 201 | Card number must be at least 11 digits. / Card number may not be longer than 19 characters. |
| 203 | Missing verification code (CVV2/CVC2). |
| 207 | Authorisation failed. |
| 208 | Communication error, please try again. |
| 210 | Verification code (CVV2/CVC2) too long. |
| 211 | Not allowed to accept this type of card. |
| 212 | Incorrect card number format. |
| 213 | Not allowed to accept this type of card. |
| 214 | Authorisation system returned incorrect response. |
| 217 | Expiry date incorrectly formatted. |
| 227 | Attempt to charge in currency x, but merchant agreement is in y. |
| 236 | Card number missing. |
5.2.14 - Eftiraskraning - Confirmation
Confirms an already existing PreAuthorization and changes it into a fully valid internet sale.
5.2.14.1 - Required input
| Field | Type | Description |
|---|---|---|
| Notandanafn | String | User name for web services login |
| Lykilord | String | Password for access to web services |
| PosiId | Integer | ID number of web POS terminal to be used. This must be a number. |
| Adgerd | String | Specifies which operation is to be run on the POS terminal. For this operation it is EFTIRASKRANING. |
| Faerslunumer | Integer | Transaction number. Number of the transaction for which the operation is run. |
| Upphaed | Integer | 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). |
| Stillingar | String | Various settings. Settings can be found in the settings table. More than one can be configured, for example: Gjaldmidill:978;Flugbokunarnumer:BX845; (Currency:978;FlightBookingNumber:BX845;) |
5.2.14.2 - Output
Information on relevant response/output for this operation can be found in the Response table found in Chapter 4.
5.2.14.3 - Error Codes
| Error Code | Description |
|---|---|
| 231 | Could not find transaction with the given transaction number. |
| 241 | The authorization for this transactionId is not a PreAuthorization, has already been confirmed or has been cancelled. |
| 600 | It is not possible to confirm an CardCheck request. |
| 242 | The confirmation amount is greater than the preAuthorization amount. |