Refund Payment After Settlement
Request (S2S HTTP POST)
This interface must be used to initiate a refund to payer after the money for the order has already been settled from Svea Payments to the merchant.
The process has several steps:
Initiate a "refund after settlement" by using this interface.
Do an actual money transfer from merchant's bank account to Svea Payments bank account by using the payment details given in the response of this interface. Merchant must use their own tools to do this money transfer. The amount and reference number of the money transfer must match the ones acquired by using this interface first.
Svea Payments will refund the payer after receiving money from the merchant
Webstore delivers the request parameters in a <form>
using POST method as hidden input fields (<input type=hidden>
) to address https://www.maksuturva.fi/PaymentCancel.pmt (or https://test1.maksuturva.fi/PaymentCancel.pmt in test environment)
Skip to contents in this page
Input name | Value | Format | Description |
---|---|---|---|
COMPULSORY PARAMETERS: | |||
| REFUND_AFTER_SETTLEMENT | AN23 | Action name. Always REFUND_AFTER_SETTLEMENT. |
| 0005 | AN4 | Version of interface content or message |
| Â | AN15 | Technical seller id given to the webstore by Svea Payments. |
| Â | AN20 | Unique Payment Identifier given to the payment transaction by the webstore. |
| Â | N17 | Same value as in send in Create Payment API ( |
| Â | AN3 | The payment currency. Same value as in send in Create Payment API ( |
| REFUND_AFTER_SETTLEMENT | AN40 | Cancellation type. Always REFUND_AFTER_SETTLEMENT |
| e.g. 15,00 | N17 | Amount to be refunded. The amount must be presented with two decimals without thousands separator. The decimal delimiter is a comma. For example: 15,00 |
| XML | AN4 | Response type. Always XML. |
| nnn | N3 | Secret key generation or version related to the technical seller id. |
OPTIONAL PARAMETERS: | |||
| Â | AN20 | OPTIONAL, yet RECOMMENDED. Unique id for cancellation. It's recommended to use this field to give a unique idenfier for a refund. When given for one refund under the given order, there cannot be another refund for the same order with the same ID. This helps to prevent accidentally sending duplicate refunds. |
| Finnish IBAN | AN36 | OPTIONAL. Buyer's refund bank account number (Finnish IBAN). This is rarely needed. The IBAN might be required in case on bank payments. That is, card payments, mobile payments, invoice payments and part payments never require nor support it. |
| Â | AN500 | OPTIONAL. Cancel description for the refund that can be shown to the buyer. |
| Â | AN5 | OPTIONAL. Cancel reason code. Reason for the refund that can be shown to the buyer.
|
| Finnish Reference Number | N20 | OPTIONAL. The Finnish reference number the merchant will use when making the money transfer to Svea. The reference number (4-20 digits) must comply with the guidelines (en, fi) for a formal reference number issued by the Federation of Finnish Financial Services (https://www.finanssiala.fi/). The reference number must be at least 4 digits, the last of which is a check digit. Currently, Credit Reference or RF Reference format (RFnn nnnn …) is not supported. This parameter is supported only separately agreed on. Please contact our customer support if needed. |
Response (XML)
The response contains the following fields:
Â
Input Name | Value | Format | C/O | Â |
---|---|---|---|---|
| REFUND_AFTER_SETTLEMENT | AN6 | C | Action called (REFUND_AFTER_SETTLEMENT). |
| 0005 | AN4 | C | Version of interface content or message. |
| Â | AN15 | C | Technical seller id given to the webstore by Svea Payments. |
| Â | AN20 | C | Unique Payment Identifier given to the payment transaction by the webstore. |
| Â | AN2 | C | Response code. Indicates success or failure. See below for the values and explanations of all the codes. |
| Â | AN100 | C | Brief description of the failure reason. Empty in case of success. |
PAYMENT DETAILS: The merchants must do an actual money transfer from their bank account to Svea Payments bank account by using these payment details | ||||
| a Finnish reference number | N20 | C | A Finnish reference number to be used when making the money transfer to Svea |
| Svea Payments Oy | AN50 | C | The recipient name to be used on the money transfer as the recipient: Svea Payments Oy |
| e.g. 15,00 | N17 | C | The money transfer amount, e.g. 15,00. Usually the same as |
| The IBAN of the bank account to pay the money to. | AN36 | C | The target bank account to be used when making the money transfer. This is Svea Payments' bank account. |
ERROR DETAILS: | ||||
| Â | N/A | O | Details of all the errors in the input message. An XML structure with root |
Response code values
Â
Response code | Short Description | Description |
---|---|---|
00 | OK | Cancel received successfully |
20 | Not found | Payment not found |
90 | Errors in input data | Errors in input data, specified in element |
91 | Duplicate detected | Payment cancellation failed, as this request was a duplicate based on the given unique identifier ( |
99 | Failed | Payment cancellation failed, reason specified in |
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pmtc>
<pmtc_action>REFUND_AFTER_SETTLEMENT</pmtc_action>
<pmtc_version>0005</pmtc_version>
<pmtc_sellerid>6234567890ABCDE</pmtc_sellerid>
<pmtc_id>VXZ8KB43XDH617LAZYBU</pmtc_id>
<pmtc_returncode>00</pmtc_returncode>
<pmtc_returntext>Cancel received succesfully</pmtc_returntext>
<pmtc_pay_with_reference>00000666660000010007</pmtc_pay_with_reference>
<pmtc_pay_with_recipientname>Svea Payments Oy</pmtc_pay_with_recipientname>
<pmtc_pay_with_amount>15,00</pmtc_pay_with_amount>
<pmtc_pay_with_iban>FI7740123477777777</pmtc_pay_with_iban>
</pmtc>
Â
Svea Payments Oy
info.payments@svea.fi
+358 9 4241 7050 (weekdays 8:00 - 16:00)
Saavutettavuusseloste