Example

Request Example (GET):

https://www.maksuturva.fi/GetPaymentMethods.pmt?gpp_sellerid=SELLERID&gpp_totalamount=573,10&request_locale=en

OK response example:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<GetMaksuturvaPartPaymentPaymentPlansResponse>
    <ResultCode>00</ResultCode>
    <ResultText>SUCCESS</ResultText>
    <SellerId>1234567890ABCDE</SellerId>
    <AmountTotal>573,10</AmountTotal>
    <PaymentPlan>
        <AnnualInterestPercentage>29,99</AnnualInterestPercentage>
        <InterestPercentage>15</InterestPercentage>
        <MonthlyFee>3,00</MonthlyFee>
        <TotalAmount>591,50</TotalAmount>
        <TotalCapital>573,10</TotalCapital>
        <TotalFee>9,00</TotalFee>
        <TotalInterest>9,40</TotalInterest>
        <PaymentPlanLineCount>3</PaymentPlanLineCount>
        <PaymentPlanLine>
            <Capital>195,00</Capital>
            <DueDate>2015-06-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>1</InstallmentNumber>
            <Interest>0,00</Interest>
            <InvoiceDate>2015-06-04</InvoiceDate>
            <Total>198,00</Total>
        </PaymentPlanLine>
        <PaymentPlanLine>
            <Capital>189,14</Capital>
            <DueDate>2015-07-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>2</InstallmentNumber>
            <Interest>5,86</Interest>
            <InvoiceDate>2015-07-04</InvoiceDate>
            <Total>198,00</Total>
        </PaymentPlanLine>
        <PaymentPlanLine>
            <Capital>188,96</Capital>
            <DueDate>2015-08-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>3</InstallmentNumber>
            <Interest>3,54</Interest>
            <InvoiceDate>2015-08-04</InvoiceDate>
            <Total>195,50</Total>
        </PaymentPlanLine>
    </PaymentPlan>
    <PaymentPlan>
        <AnnualInterestPercentage>31,04</AnnualInterestPercentage>
        <InterestPercentage>15</InterestPercentage>
        <MonthlyFee>3,00</MonthlyFee>
        <TotalAmount>611,96</TotalAmount>
        <TotalCapital>573,10</TotalCapital>
        <TotalFee>18,00</TotalFee>
        <TotalInterest>20,86</TotalInterest>
        <PaymentPlanLineCount>6</PaymentPlanLineCount>
        <PaymentPlanLine>
            <Capital>100,00</Capital>
            <DueDate>2015-06-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>1</InstallmentNumber>
            <Interest>0,00</Interest>
            <InvoiceDate>2015-06-04</InvoiceDate>
            <Total>103,00</Total>
        </PaymentPlanLine>
        <PaymentPlanLine>
            ...
        </PaymentPlanLine>
        <PaymentPlanLine>
            ...
        </PaymentPlanLine>
        ...
    </PaymentPlan>
    <PaymentPlan>
        ...
    </PaymentPlan>
    <PaymentPlan>
        ...
    </PaymentPlan>
    ...
    <PaymentPlan>
        <AnnualInterestPercentage>29,98</AnnualInterestPercentage>
        <InterestPercentage>15</InterestPercentage>
        <MonthlyFee>3,00</MonthlyFee>
        <TotalAmount>733,96</TotalAmount>
        <TotalCapital>573,10</TotalCapital>
        <TotalFee>72,00</TotalFee>
        <TotalInterest>88,86</TotalInterest>
        <PaymentPlanLineCount>24</PaymentPlanLineCount>
        <PaymentPlanLine>
            <Capital>28,00</Capital>
            <DueDate>2015-06-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>1</InstallmentNumber>
            <Interest>0,00</Interest>
            <InvoiceDate>2015-06-04</InvoiceDate>
            <Total>31,00</Total>
        </PaymentPlanLine>
        <PaymentPlanLine>
            <Capital>21,02</Capital>
            <DueDate>2015-07-18</DueDate>
            <Fee>3,00</Fee>
            <InstallmentNumber>2</InstallmentNumber>
            <Interest>6,98</Interest>
            <InvoiceDate>2015-07-04</InvoiceDate>
            <Total>31,00</Total>
        </PaymentPlanLine>
        <PaymentPlanLine>
            ...
        </PaymentPlanLine>
        <PaymentPlanLine>
            ...
        </PaymentPlanLine>
        ...
    </PaymentPlan>
</GetMaksuturvaPartPaymentPaymentPlansResponse>

NO_PLANS_AVAILABLE response example

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<GetMaksuturvaPartPaymentPaymentPlansResponse>
    <ResultCode>10</ResultCode>
    <ResultText>NO_PLANS_AVAILABLE</ResultText>
    <SellerId>1234567890ABCDE</SellerId>
    <AmountTotal>1,00</AmountTotal>
    <Error name="gpp_amounttotal" type="field">The credit provider did not return any payment plans for the given total amount.</Error>
</GetMaksuturvaPartPaymentPaymentPlansResponse>

ERROR response examples:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<GetMaksuturvaPartPaymentPaymentPlansResponse>
    <ResultCode>99</ResultCode>
    <ResultText>ERROR</ResultText>
    <SellerId>1234567890ABCD</SellerId>
    <AmountTotal>573,10</AmountTotal>
    <Error name="gpp_sellerid" type="field">Invalid request parameter gpp_sellerid value "1234567890ABCD"</Error>
</GetMaksuturvaPartPaymentPaymentPlansResponse>
 
 
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<GetMaksuturvaPartPaymentPaymentPlansResponse>
    <ResultCode>99</ResultCode>
    <ResultText>ERROR</ResultText>
    <SellerId>1234567890ABCDE</SellerId>
    <AmountTotal>aaa</AmountTotal>
    <Error name="gpp_amounttotal" type="field">Invalid request parameter gpp_amounttotal value "aaa"</Error>
</GetMaksuturvaPartPaymentPaymentPlansResponse>
 
 
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<GetMaksuturvaPartPaymentPaymentPlansResponse>
    <ResultCode>99</ResultCode>
    <ResultText>ERROR</ResultText>
    <SellerId>1234567890ABCDE</SellerId>
    <AmountTotal>10000,01</AmountTotal>
    <Error type="general">Response from the credit provider: The purchase amount exeeds the maximum allowed limit.</Error>
</GetMaksuturvaPartPaymentPaymentPlansResponse>