Request example

Requesting information about January 8th 2024 settlements:

curl --request POST \
  --url https://test1.maksuturva.fi/GetCompensationsByTimeInterval.pmt \
  --header 'Authorization: Basic c2VsbGVySWQ6c2VjcmV0S2V5' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data gc_action=GET_SETTLEMENTS_XML \
  --data gc_version=0003 \
  --data gc_sellerid=ABC123DE\
  --data gc_begindate=14.10.2023 \
  --data gc_enddate=14.10.2023 \
  --data gc_keygeneration=001

Examples XML-responses (HTTP RESPONSE)

OK Response containing a single settlement done using the webstore's original payment reference (`pmt_reference`):

<?xml version="1.0" encoding="UTF-8"?>
<ns0:getCompensationsResponse xmlns:ns0="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
  <version>0001</version>
  <timestamp>2024-01-09T14:22:01+02:00</timestamp>
  <sellerId>ABC123DE</sellerId>
  <resultCode>00</resultCode>
  <resultText>OK</resultText>
  <keyGeneration>1</keyGeneration>
  <compensations>
    <compensation>
      <compensationType>SINGLE</compensationType>
      <compensationDate>2024-01-08T14:19:56+02:00</compensationDate>
      <reference>99990000000000191247</reference>
      <grossAmount>330.35</grossAmount>
      <netAmount>272.45</netAmount>
      <refundedAmount>49.95</refundedAmount>
      <commission>7.95</commission>
      <commissionVat>1.54</commissionVat>
      <commissionVatRate>24</commissionVatRate>
      <orders>
        <order>
          <orderNumber>2007</orderNumber>
          <originalReference>02310281352439178221</originalReference>
          <paymentId>1007</paymentId>
          <sellerGrossAmount>330.35</sellerGrossAmount>
          <sellerNetAmount>272.45</sellerNetAmount>
          <refundedAmount>49.95</refundedAmount>
          <commission>7.95</commission>
          <commissionVat>1.54</commissionVat>
          <commissionVatRate>24</commissionVatRate>
          <buyerPaymentDateTime>2024-01-08T14:14:40.689+02:00</buyerPaymentDateTime>
          <paymentMethod>FIBI</paymentMethod>
          <paymentMethodGroup>SVEA_B2B_INVOICE</paymentMethodGroup>
        </order>
      </orders>
    </compensation>
  </compensations>
</ns0:getCompensationsResponse>

OK Response containing one bundle settlement with reference number 1232 consisting of two payments or orders:

<?xml version="1.0" encoding="UTF-8"?>
<ns0:getCompensationsResponse xmlns:ns0="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
  <version>0001</version>
  <timestamp>2024-01-09T14:22:01+02:00</timestamp>
  <sellerId>ABC123DE</sellerId>
  <resultCode>00</resultCode>
  <resultText>OK</resultText>
  <keyGeneration>1</keyGeneration>
  <compensations>
    <compensation>
      <compensationCode>10000000000000700000</compensationCode>
      <compensationType>BUNDLE</compensationType>
      <compensationDate>2024-01-08T14:19:56+02:00</compensationDate>
      <reference>00000000000000001232</reference>
      <grossAmount>529.35</grossAmount>
      <netAmount>410.95</netAmount>
      <refundedAmount>108.95</refundedAmount>
      <commission>9.45</commission>
      <commissionVat>1.54</commissionVat>
      <orders>
        <order>
          <bundleCode>10000000000000700000</bundleCode>
          <orderNumber>2006</orderNumber>
          <originalReference>00000002365691421113</originalReference>
          <paymentId>1006</paymentId>
          <sellerGrossAmount>199</sellerGrossAmount>
          <sellerNetAmount>138.5</sellerNetAmount>
          <refundedAmount>59</refundedAmount>
          <commission>1.5</commission>
          <commissionVat>0.00</commissionVat>
          <commissionVatRate>0</commissionVatRate>
          <buyerPaymentDateTime>2024-01-08T14:14:40.689+02:00</buyerPaymentDateTime>
          <paymentMethod>FIOB</paymentMethod>
          <paymentMethodGroup>BANK_PAYMENTS</paymentMethodGroup>
        </order>
        <order>
          <bundleCode>10000000000000700000</bundleCode>
          <orderNumber>2007</orderNumber>
          <originalReference>02310281352439178221</originalReference>
          <paymentId>1007</paymentId>
          <sellerGrossAmount>330.35</sellerGrossAmount>
          <sellerNetAmount>272.45</sellerNetAmount>
          <refundedAmount>49.95</refundedAmount>
          <commission>7.95</commission>
          <commissionVat>1.54</commissionVat>
          <commissionVatRate>24</commissionVatRate>
          <buyerPaymentDateTime>2024-01-08T14:14:40.689+02:00</buyerPaymentDateTime>
          <paymentMethod>FIBI</paymentMethod>
          <paymentMethodGroup>SVEA_B2B_INVOICE</paymentMethodGroup>
        </order>
      </orders>
    </compensation>
  </compensations>
</ns2:getCompensationsResponse>

Svea Payments API

Retrieve Settlement Reports examples

Analytics

Request example

Requesting information about January 8th 2024 settlements:

Examples XML-responses (HTTP RESPONSE)

OK Response containing a single settlement done using the webstore's original payment reference (`pmt_reference`):

OK Response containing one bundle settlement with reference number 1232 consisting of two payments or orders:

The requested date interval did not contain any settlements:

The requested date interval exceeded the maximum of one month:

Related content

Retrieve Settlement Reports examples

Request example

Requesting information about January 8th 2024 settlements:

Examples XML-responses (HTTP RESPONSE)

OK Response containing a single settlement done using the webstore's original payment reference (pmt_reference):

OK Response containing one bundle settlement with reference number 1232 consisting of two payments or orders:

The requested date interval did not contain any settlements:

The requested date interval exceeded the maximum of one month:

Related content

OK Response containing a single settlement done using the webstore's original payment reference (`pmt_reference`):