POST api/KaupGreidslusedlar

Charge a purchase with a giro. Idempotency available by providing guid in Idempotency-Key header, idempotency life time is 24hours.

Request Information

URI Parameters

None.

Body Parameters

Target purchase to charge.

KaupGreidslusedillInntakDto
NameDescriptionTypeAdditional information
Tilvisun

/// Claim Reference.

string

Matching regular expression pattern: ^[0-9A-Za-z]{0,16}$

YtriTilvisun

External Reference for order.

string

None.

VidskiptamannaNr

Business number.

string

Matching regular expression pattern: ^[0-9A-Za-z]{0,16}$

Audkenni

Identifier.

string

Matching regular expression pattern: ^[A-Z0-9]{2,3}$

FyrstiGjalddagi

First due date. Nullable: default value of vendor is used if no date is given.

date

None.

FresturEindaga

Deadline day limit. Nullable: default value of vendor is used if no date is given.

integer

Range: inclusive between 0 and 2147483647

SeljandiId

Vendor id.

integer

Range: inclusive between 1 and 2147483647

Kaupandi

Buyer information.

KaupandiDto

Required

Solulinur

Purchased items.

Collection of SolulinaDto

None.

SamtalsMedVsk

Sales total including VAT.

decimal number

Range: inclusive between 1 and 2147483647

FjoldiGjalddaga

Total number of payments.

integer

Range: inclusive between 1 and 36

AthugunVanskilaEkkiLeyfd

Credit check forbidden.

boolean

None.

KaupandiAudkenndur

Has the buyer been authenticated.

boolean

None.

Request Formats

application/json, text/json

Sample:
{
  "Tilvisun": "sample string 1",
  "YtriTilvisun": "sample string 2",
  "VidskiptamannaNr": "sample string 3",
  "Audkenni": "sample string 4",
  "FyrstiGjalddagi": "2025-12-06T04:38:44.2186443+00:00",
  "FresturEindaga": 1,
  "SeljandiId": 5,
  "Kaupandi": {
    "Nafn": "sample string 1",
    "Kennitala": "sample string 2",
    "Netfang": "sample string 3",
    "Farsimanumer": "sample string 4"
  },
  "Solulinur": [
    {
      "Vorunumer": "sample string 1",
      "Voruheiti": "sample string 2",
      "Magn": 3.1,
      "Eining": "sample string 4",
      "Einingaverd": 5.0,
      "Skattaflokkur": "sample string 6",
      "UpphaedMedVsk": 7.0
    },
    {
      "Vorunumer": "sample string 1",
      "Voruheiti": "sample string 2",
      "Magn": 3.1,
      "Eining": "sample string 4",
      "Einingaverd": 5.0,
      "Skattaflokkur": "sample string 6",
      "UpphaedMedVsk": 7.0
    }
  ],
  "SamtalsMedVsk": 6.0,
  "FjoldiGjalddaga": 7,
  "AthugunVanskilaEkkiLeyfd": true,
  "KaupandiAudkenndur": true
}

application/xml, text/xml

Sample:
<KaupGreidslusedillInntakDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Greidslumidlun.Api.Dto.Kaup">
  <AthugunVanskilaEkkiLeyfd>true</AthugunVanskilaEkkiLeyfd>
  <FjoldiGjalddaga>7</FjoldiGjalddaga>
  <Kaupandi>
    <Farsimanumer>sample string 4</Farsimanumer>
    <Kennitala>sample string 2</Kennitala>
    <Nafn>sample string 1</Nafn>
    <Netfang>sample string 3</Netfang>
  </Kaupandi>
  <KaupandiAudkenndur>true</KaupandiAudkenndur>
  <SamtalsMedVsk>6</SamtalsMedVsk>
  <SeljandiId>5</SeljandiId>
  <Solulinur>
    <SolulinaDto>
      <Eining>sample string 4</Eining>
      <Einingaverd>5</Einingaverd>
      <Magn>3.1</Magn>
      <Skattaflokkur>sample string 6</Skattaflokkur>
      <UpphaedMedVsk>7</UpphaedMedVsk>
      <Voruheiti>sample string 2</Voruheiti>
      <Vorunumer>sample string 1</Vorunumer>
    </SolulinaDto>
    <SolulinaDto>
      <Eining>sample string 4</Eining>
      <Einingaverd>5</Einingaverd>
      <Magn>3.1</Magn>
      <Skattaflokkur>sample string 6</Skattaflokkur>
      <UpphaedMedVsk>7</UpphaedMedVsk>
      <Voruheiti>sample string 2</Voruheiti>
      <Vorunumer>sample string 1</Vorunumer>
    </SolulinaDto>
  </Solulinur>
  <Audkenni>sample string 4</Audkenni>
  <FresturEindaga>1</FresturEindaga>
  <FyrstiGjalddagi>2025-12-06T04:38:44.2186443+00:00</FyrstiGjalddagi>
  <Tilvisun>sample string 1</Tilvisun>
  <VidskiptamannaNr>sample string 3</VidskiptamannaNr>
  <YtriTilvisun>sample string 2</YtriTilvisun>
</KaupGreidslusedillInntakDto>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'KaupGreidslusedillInntakDto'.

Response Information

Resource Description

FramkvaemaKaupUttakDto
NameDescriptionTypeAdditional information
KaupId

Purchase ID.

integer

None.

Response Formats

application/json, text/json

Sample:
{
  "KaupId": 1
}

application/xml, text/xml

Sample:
<FramkvaemaKaupUttakDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Greidslumidlun.Api.Dto.Kaup">
  <KaupId>1</KaupId>
</FramkvaemaKaupUttakDto>