Skip to content

5 - Vefþjónusta

Upplýsingar um vefslóð vefþjónustu og fleira tengt prófunum má finna í kafla 2.

5.1 - EndurgreidaSolu

Þetta fall endurgreiðir sölu sem framkvæmd var í gegnum Greiðslusíðuna.

Vinsamlegast athugið

Ekki er hægt að endurgreiða sölu sem hefur þegar verið endurgreidd eða ógild.

Hægt er að ógilda sölu með fallinu OgildaSolu ef það er gert innan sama dags.

5.1.1 - Skilgreiningar

5.1.1.1 - Request

Svæði. Teg. Len. min Len. max Notk. Lýsing
VefverslunID N 1 9 M Einkvæmt auðkenni söluaðila (MerchantID).
Oryggisnumer S 1 50 M Öryggisnúmer söluaðila (VerificationCode).
VefverslunSalaID S 36 36 M Einkvæmt auðkenni sölu. Þegar kallað er á slóð hjá söluaðila (PaymentSuccessfulServerSideURL) er þetta gildi sett í SaleID færibreytuna. Sjá nánar í kafla 4.1.2.

5.1.1.2 - Response

Svæði. Teg. Len. min Len. max Notk. Lýsing
Villunumer N - - - Villunúmer. Ef 0 þá kom engin villa upp og endurgreiðsla tókst.
VilluTexti S - - - Lýsing á villu.

5.1.2 - Dæmi

5.1.2.1 - Request

``` XML tab="XML"

\
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> 123 abc123 E1052BA1-EF88-4809-AF0A-000092577CD5 

#### 5.1.2.2 - Response

``` XML tab="XML"
<?xml version="1.0" encoding="utf-8"?>
<EndurgreidaSolu xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://greidslusida.valitor.is">
<Villunumer>0</Villunumer>
<VilluTexti />
</EndurgreidaSolu>

5.1.2.3 - Response villa

``` XML tab="XML"

Vefverslun ekki til. 1 

### 5.1.3 - Villur

Villur sem geta komið upp má finna [hér](Errors.md#71-villutafla)

## 5.2 - OgildaSolu (VoidSale)

Þetta fall ógildir sölu sem framkvæmd var í gegnum Greiðslusíðuna. 

!!! attention "Vinsamlegast athugið"
    Ekki er hægt að ógilda sölu sem hefur þegar verið ógild eða endurgreidd.

### 5.2.1 - Skilgreiningar

#### 5.2.1.1 - Request

<table>
  <tr>
    <th>Svæði</th>
    <th>Teg</th>
    <th>Len. min</th>
    <th>Len. max</th>
    <th>Notk</th>
    <th>Lýsing</th>
  </tr>
  <tr>
    <td>VefverslunID</td>
    <td>N</td>
    <td>1</td>
    <td>9</td>
    <td>M</td>
    <td>Einkvæmt auðkenni söluaðila (MerchantID).</td>
  </tr>
  <tr>
    <td>Oryggisnumer</td>
    <td>S</td>
    <td>1</td>
    <td>50</td>
    <td>M</td>
    <td>Öryggisnúmer söluaðila (VerificationCode).</td>
  </tr>
  <tr>
    <td>VefverslunSalaID</td>
    <td>S</td>
    <td>36</td>
    <td>36</td>
    <td>M</td>
    <td>ID sölu, þarf að vera einstakt. Þegar að kallað er í veflóð söluaðila (PaymentSuccessfulServerSideURL) er þetta gildi sett í SaleID svæðið. Sjá nánar í kafla 4.1.2.</td>
  </tr>
</table>

#### 5.2.1.2 - Response

<table>
  <tr>
    <th>Svæði</th>
    <th>Teg.</th>
    <th>Len. min</th>
    <th>Len. max</th>
    <th>Notk</th>
    <th>Lýsing</th>
  </tr>
  <tr>
    <td>Villunumer</td>
    <td>N</td>
    <td>-</td>
    <td>-</td>
    <td>-</td>
    <td>Villunúmer. Ef 0 þá kom engin villa upp og endurgreiðsla tókst.</td>
  </tr>
  <tr>
    <td>Villutexti</td>
    <td>S</td>
    <td>-</td>
    <td>-</td>
    <td>-</td>
    <td>Lýsing á villu.</td>
  </tr>
</table>


### 5.2.2 - Dæmi

#### 5.2.2.1 - Request

``` XML tab="XML"
<?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>
<OgildaSolu xmlns="https://greidslusida.valitor.is">
<VefverslunID>123</VefverslunID>
<Oryggisnumer>abc123</Oryggisnumer>
<VefverslunSalaID>E1052BA1-EF88-4809-AF0A-000092577CD5</VefverslunSalaID>
</OgildaSolu>
</soap:Body> </soap:Envelope>

5.2.2.2 - Response

``` XML tab="XML"

0 

#### 5.2.2.3 - Response villa

``` XML tab="XML"
<?xml version="1.0" encoding="utf-8"?>
<OgildaSolu xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://greidslusida.valitor.is">
<VilluTexti>Vefverslun ekki til.</VilluTexti>
<Villunumer>1</Villunumer>
</OgildaSolu>

5.2.3 - Villur

Villur sem geta komið upp má finna hér

5.3 - SkilaMd5

Þetta fall reiknar út MD5 hash fyrir streng sem er sendur inn.

Hægt er að nota þetta fall til að athuga hvort að verið sé að nota rétt MD5 hash.

5.3.1 - Skilgreiningar

5.3.1.1 - Request

Svæði Teg. Len. min Len. max Notk Lýsing
inp S - - O Strengur sem á að taka hash af.

5.3.1.2 - Response

Svæði Teg. Len. min Len. max Notk Lýsing
SkilaMd5ASCIIResult S - - O MD5 hash af strengnum sem var sendur inn.

5.3.2 - Dæmi

5.3.2.1 - Request

``` XML tab="XML"

abc 

#### 5.3.2.2 - Response

``` XML tab="XML"
<?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>
<SkilaMd5Response xmlns="https://greidslusida.valitor.is/">
<SkilaMd5Result>CE1473CF80C6B3FDA8E3DFC006ADC315</SkilaMd5Result>
</SkilaMd5Response>
</soap:Body>
</soap:Envelope>

5.4 - SkilaMd5ASCII

Þetta fall reiknar út MD5 hash fyrir streng sem er sendur inn á sama hátt og PHP gerir.

Hægt er að nota þetta fall til að athuga hvort að verið sé að nota rétt MD5 hash.

5.4.1 - Skilgreiningar

5.4.1.1 - Request

Svæði Teg Len. min Len. max Notk Lýsing
inp S - - O Strengur sem á að taka hash af.

5.4.1.2 - Response

Svæði Teg Len. min Len. max Notk Lýsing
SkilaMd5ASCIIResult S - - O MD5 hash af strengnum sem var sendur inn.

5.4.2 - Dæmi

5.4.2.1 - Request

``` XML tab="XML"

abc } 

#### 5.4.2.2 - Response

``` XML tab="XML"
<?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>
<SkilaMd5ASCIIResponse xmlns="https://greidslusida.valitor.is/">
<SkilaMd5ASCIIResult>900150983cd24fb0d6963f7d28e17f72</SkilaMd5ASCIIResult>
</SkilaMd5ASCIIResponse>
</soap:Body>
</soap:Envelope>

5.5 - SkilaSha256

Þetta fall reiknar út SHA256 hash (unicode) fyrir streng sem er sendur inn.

Hægt er að nota þetta fall til að athuga hvort að verið sé að nota rétt SHA256 hash.

5.5.1 - Skilgreiningar

5.5.1.1 - Request

Svæði Teg Len. min Len. max Notk Lýsing
inp S - - O Strengur sem á að taka hash af.

5.5.1.2 - Response

Svæði Teg Len. min Len. max Notk Lýsing
SkilaSha256Result S - - - SHA256 hash af strengnum sem var sendur inn.

5.5.2 - Dæmi

5.5.2.1 - Request

``` XML tab="XML"

abc 

#### 5.5.2.2 - Response

``` XML tab="XML"
<?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>
<SkilaSha256Response xmlns="https://greidslusida.valitor.is/">
<SkilaSha256Result>13e228567e8249fce53337f25d7970de3bd68ab2653424c7
b8f9fd05e33caedf</SkilaSha256Result>
</SkilaSha256Response>
</soap:Body>
</soap:Envelope>

5.6 - SkilaSha256ASCII

Þetta fall reiknar út SHA256 hash (ASCII) fyrir streng sem er sendur inn.

Hægt er að nota þetta fall til að athuga hvort að verið sé að nota rétt SHA256 hash.

5.6.1 - Skilgreiningar

5.6.1.1 - Request

Svæði Teg Len. min Len. max Notk Lýsing
inp S - - O Strengur sem á að taka hash af.

5.6.1.2 - Response

Svæði Teg Len. min Len. max Notk Lýsing
inp S - - O SHA256 hash af strengnum sem var sendur inn.

5.6.2 - Dæmi

5.6.2.1 - Request

``` XML tab="XML"

abc 

#### 5.6.2.2 - Response

``` XML tab="XML"
<?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>
<SkilaSha256ASCIIResponse xmlns="https://greidslusida.valitor.is/">
<SkilaSha256ASCIIResult>13e228567e8249fce53337f25d7970de3bd68ab2653424c7
b8f9fd05e33caedf</SkilaSha256ASCIIResult>
</SkilaSha256ASCIIResponse>
</soap:Body>
</soap:Envelope>