Payment refunds and cancellations

Skip to contents in this page

1 Payment refunds and cancellations
- 1.1 Request examples (HTTP POST)
  - 1.1.1 Full refund:
  - 1.1.2 Partial refund of 123,00 € and return of deliveries:
  - 1.1.3 Partial refund 250,00 € after settlement:
- 1.2 XML Response examples (HTTP RESPONSE)
  - 1.2.1 OK Response:
  - 1.2.2 OK Response (refund after settlement):
  - 1.2.3 Error response:

Request examples (HTTP POST)

Full refund:

<form method="post" action="https://test1.maksuturva.fi/PaymentCancel.pmt">
    <input type="hidden" name="pmtc_action"            value="CANCEL" />
    <input type="hidden" name="pmtc_version"           value="0005" />
    <input type="hidden" name="pmtc_sellerid"          value="ABC123DE" />
    <input type="hidden" name="pmtc_id"                value="1998524_1" />
    <input type="hidden" name="pmtc_amount"            value="568,10" />
    <input type="hidden" name="pmtc_currency"          value="EUR" />
    <input type="hidden" name="pmtc_canceltype"        value="FULL_REFUND" />
    <input type="hidden" name="pmtc_canceldescription" value="Valitettavasti tuotteet olivat päässeet loppumaan varastosta." />
    <input type="hidden" name="pmtc_cancelreason"      value="OUTOF" />
    <input type="hidden" name="pmtc_resptype"          value="XML" />
    <input type="hidden" name="pmtc_keygeneration"     value="1" />
    <input type="hidden" name="pmtc_cancel_id"         value"1998524_1_refund_01" />
</form>

Partial refund of 123,00 € and return of deliveries:

<form method="post" action="https://test1.maksuturva.fi/PaymentCancel.pmt">
    <input type="hidden" name="pmtc_action"            value="CANCEL" />
    <input type="hidden" name="pmtc_version"           value="0005" />
    <input type="hidden" name="pmtc_sellerid"          value="ABC123DE" />
    <input type="hidden" name="pmtc_id"                value="1998524_1" />
    <input type="hidden" name="pmtc_amount"            value="568,10" />
    <input type="hidden" name="pmtc_currency"          value="EUR" />
    <input type="hidden" name="pmtc_canceltype"        value="PARTIAL_REFUND_AND_RETURN_OF_DELIVERIES" />
    <input type="hidden" name="pmtc_cancelamount"      value="123,00" />
    <input type="hidden" name="pmtc_canceldescription" value="Ostaja palauttaa toisen tilaamistaan tuote A:sta" />
    <input type="hidden" name="pmtc_cancelreason"      value="DEFEC" />
    <input type="hidden" name="pmtc_resptype"          value="XML" />
    <input type="hidden" name="pmtc_keygeneration"     value="1" />
    <input type="hidden" name="pmtc_cancel_id"         value"1998524_1_refund_01" />
</form>

Partial refund 250,00 € after settlement:

<form method="post" action="https://test1.maksuturva.fi/PaymentCancel.pmt">
    <input type="hidden" name="pmtc_action"            value="REFUND_AFTER_SETTLEMENT" />
    <input type="hidden" name="pmtc_version"           value="0005" />
    <input type="hidden" name="pmtc_sellerid"          value="ABC123DE" />
    <input type="hidden" name="pmtc_id"                value="1998524_1" />
    <input type="hidden" name="pmtc_amount"            value="568,10" />
    <input type="hidden" name="pmtc_currency"          value="EUR" />
    <input type="hidden" name="pmtc_canceltype"        value="REFUND_AFTER_SETTLEMENT" />
    <input type="hidden" name="pmtc_cancelamount"      value="250,00" />
    <input type="hidden" name="pmtc_canceldescription" value="Ostaja palauttaa toisen tilaamistaan tuote A:sta" />
    <input type="hidden" name="pmtc_cancelreason"      value="OTHER" />
    <input type="hidden" name="pmtc_resptype"          value="XML" />
    <input type="hidden" name="pmtc_keygeneration"     value="1" />
    <input type="hidden" name="pmtc_cancel_id"         value"1998524_1_refund_02" />
</form>

XML Response examples (HTTP RESPONSE)

OK Response:

<pmtc>
    <pmtc_action>CANCEL</pmtc_action>
    <pmtc_version>0005</pmtc_version>
    <pmtc_sellerid>ABC123DE</pmtc_sellerid>
    <pmtc_id>1998524_1</pmtc_id>
    <pmtc_returncode>00</pmtc_returncode>
    <pmtc_returntext>Cancel received succesfully</pmtc_returntext>
</pmtc>

OK Response (refund after settlement):

<pmtc>
	<pmtc_action>REFUND_AFTER_SETTLEMENT</pmtc_action>
	<pmtc_version>0005</pmtc_version>
	<pmtc_sellerid>ABC123DE</pmtc_sellerid>
	<pmtc_id>1998524_1</pmtc_id>
	<pmtc_returncode>00</pmtc_returncode>
	<pmtc_returntext>Cancel received succesfully</pmtc_returntext>
	<pmtc_pay_with_reference>00000660123456789014</pmtc_pay_with_reference>
	<pmtc_pay_with_recipientname>Svea Payments Oy</pmtc_pay_with_recipientname>
	<pmtc_pay_with_amount>250,00</pmtc_pay_with_amount>
	<pmtc_pay_with_iban>FI2712345612345673</pmtc_pay_with_iban>
</pmtc>

Error response:

(missing pmtc_cancelamount from the request e.g. in case of a partial refund)

<pmtc>
    <pmtc_action>CANCEL</pmtc_action>
    <pmtc_version>0005</pmtc_version>
    <pmtc_sellerid>ABC123DE</pmtc_sellerid>
    <pmtc_id>1998524_1</pmtc_id>
    <pmtc_returncode>90</pmtc_returncode>
    <pmtc_returntext>Errors in input data, specified in element errors</pmtc_returntext>
    <errors>
        <error name="pmtc_cancelamount" type="field">pmtc_cancelamount is invalid</error>
    </errors>
</pmtc>

Svea Payments API

Refunds and Cancellations examples

Payment refunds and cancellations

Request examples (HTTP POST)

Full refund:

Partial refund of 123,00 € and return of deliveries:

Partial refund 250,00 € after settlement:

XML Response examples (HTTP RESPONSE)

OK Response:

OK Response (refund after settlement):

Error response:

Related content