Compensation report

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>

Esimerkkejä XML-vastauksista (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>

The requested date interval did not contain any settlements:

<ns2:getCompensationsResponse xmlns:ns2="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
    <timestamp>2014-10-16T14:09:17.000+03:00</timestamp>
    <sellerId>ABC123DE</sellerId>
    <resultCode>95</resultCode>
    <resultText>No events found.</resultText>
    <keyGeneration>1</keyGeneration>
</ns2:getCompensationsResponse>

The requested date interval exceeded the maximum of one month:

<ns2:getCompensationsResponse xmlns:ns2="https://www.maksuturva.fi/smtschema/GetCompensationsResponse.xsd">
    <timestamp>2014-10-16T14:07:45.000+03:00</timestamp>
    <sellerId>ABC123DE</sellerId>
    <resultCode>95</resultCode>
    <resultText>Errors in: {[gc_enddate:the given interval is too big. Maximum allowed is one month.]}</resultText>
    <keyGeneration>1</keyGeneration>
</ns2:getCompensationsResponse>