This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.
New documentation can be found here: Home
Retrieve Settlement Report examples
- Aleksi Ahonen
Owned by Aleksi Ahonen
Â
Skip to contents in this page
- 1 Request example (HTTP POST)
- 2 Examples XML-responses (HTTP RESPONSE)
- 2.1 OK Response containing a single settlement done using the webstore's original payment reference:
- 2.2 OK Response containing one bundle settlement with reference number 1232 consisting of two payments or orders:
- 2.3 The requested date interval did not contain any settlements:
- 2.4 The requested date interval exceeded the maximum of one month:
Request example (HTTP POST)
Â
Requesting information about October 14th 2014 settlements:
<form method="post" action="https://test1.maksuturva.fi/GetCompensationsByTimeInterval.pmt">
<input type="hidden" name="gc_action" value="GET_COMPENSATIONS" />
<input type="hidden" name="gc_version" value="0001" />
<input type="hidden" name="gc_sellerid" value="ABC123DE" />
<input type="hidden" name="gc_begindate" value="14.10.2014" />
<input type="hidden" name="gc_enddate" value="14.10.2014" />
<input type="hidden" name="gc_hashversion" value="SHA-256" />
<input type="hidden" name="gc_keygeneration" value="001" />
<input type="hidden" name="gc_hash" value="CFDDF22DD538FFECF6F784F5E10C88A3704ED597E700DE6A36979D868574B8C4" />
<input type="submit" value="Hae raportti">
</form>Examples XML-responses (HTTP RESPONSE)
Â
OK Response containing a single settlement done using the webstore's original payment reference:
(pmt_reference)
Â
Â
<ns2:getCompensationsResponse xmlns:ns2="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
<version>0001</version>
<timestamp>2014-10-16T14:14:51.000+03:00</timestamp>
<sellerId>ABC123DE</sellerId>
<resultCode>00</resultCode>
<resultText>OK</resultText>
<hashVersion>SHA-256</hashVersion>
<keyGeneration>1</keyGeneration>
<hash>9B7ADF7633688101301E8F7617E996777D329A390F56FD135BE0122C46745BEC</hash>
<compensations>
<compensation>
<compensationType>SINGLE</compensationType>
<compensationDate>2014-10-14T00:00:00.000+03:00</compensationDate>
<reference>00000001234567890120</reference>
<grossAmount>573.1</grossAmount>
<netAmount>564.31</netAmount>
<refundedAmount>0</refundedAmount>
<commission>8.79</commission>
<orders>
<order>
<orderNumber>1998524</orderNumber>
<originalReference>1234567890120</originalReference>
<paymentId>1998524_1</paymentId>
<sellerGrossAmount>573.1</sellerGrossAmount>
<sellerNetAmount>564.31</sellerNetAmount>
<refundedAmount>0</refundedAmount>
<commission>8.79</commission>
<buyerPaymentDateTime>2014-09-27T00:00:00.000+03:00</buyerPaymentDateTime>
</order>
</orders>
</compensation>
</compensations>
</ns2:getCompensationsResponse>OK Response containing one bundle settlement with reference number 1232 consisting of two payments or orders:
<ns2:getCompensationsResponse xmlns:ns2="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
<version>0001</version>
<timestamp>2014-10-16T14:27:26.000+03:00</timestamp>
<sellerId>ABC123DE</sellerId>
<resultCode>00</resultCode>
<resultText>OK</resultText>
<hashVersion>SHA-256</hashVersion>
<keyGeneration>1</keyGeneration>
<hash>E7BE30D784E97F98673E28F2570CF69AEE03810BE51E5EA773FD0E6ADAC99547</hash>
<compensations>
<compensation>
<compensationCode>10000000000000000000</compensationCode>
<compensationType>BUNDLE</compensationType>
<compensationDate>2014-10-14T14:27:12.000+03:00</compensationDate>
<reference>00000000000000001232</reference>
<grossAmount>1146.20</grossAmount>
<netAmount>1051.44</netAmount>
<refundedAmount>0.00</refundedAmount>
<commission>94.76</commission>
<orders>
<order>
<bundleCode>10000000000000000000</bundleCode>
<orderNumber>1998524</orderNumber>
<originalReference>19985242</originalReference>
<paymentId>1998524_1</paymentId>
<sellerGrossAmount>573.1</sellerGrossAmount>
<sellerNetAmount>564.31</sellerNetAmount>
<refundedAmount>0</refundedAmount>
<commission>8.79</commission>
<buyerPaymentDateTime>2014-09-27T00:00:00.000+03:00</buyerPaymentDateTime>
</order>
<order>
<bundleCode>10000000000000000000</bundleCode>
<orderNumber>2000301</orderNumber>
<originalReference>20003016</originalReference>
<paymentId>2000301_1</paymentId>
<sellerGrossAmount>573.1</sellerGrossAmount>
<sellerNetAmount>487.13</sellerNetAmount>
<refundedAmount>0</refundedAmount>
<commission>85.97</commission>
<buyerPaymentDateTime>2014-09-30T00:00:00.000+03:00</buyerPaymentDateTime>
</order>
</orders>
</compensation>
</compensations>
</ns2:getCompensationsResponse>