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

1 Request (S2S HTTP POST)
- 1.1 The process has several steps:
2 Response (XML)
- 2.1 Response code values
- 2.2 Example Response

Input name	Value	Format	Description

Input name	Value	Format	Description
COMPULSORY PARAMETERS: All of these must be present in the request.
`pmtc_action`	REFUND_AFTER_SETTLEMENT	AN23	Action name. Always REFUND_AFTER_SETTLEMENT.
`pmtc_version`	0005	AN4	Version of interface content or message
`pmtc_sellerid`		AN15	Technical seller id given to the webstore by Svea Payments.
`pmtc_id`		AN20	Unique Payment Identifier given to the payment transaction by the webstore.
`pmtc_amount`		N17	Same value as in send in Create Payment API (`pmt_amount`). The amount must be presented with two decimals. The decimal delimiter is comma, e.g. 94,80
`pmtc_currency`		AN3	The payment currency. Same value as in send in Create Payment API (`pmt_currency`).
`pmtc_canceltype`	REFUND_AFTER_SETTLEMENT	AN40	Cancellation type. Always REFUND_AFTER_SETTLEMENT
`pmtc_cancelamount`	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
`pmtc_resptype`	XML	AN4	Response type. Always XML.
`pmtc_keygeneration`	nnn e.g. 001	N3	Secret key generation or version related to the technical seller id. Default or initial value is 001.
OPTIONAL PARAMETERS: An optional parameter may be missing altogether, have an empty value or have a value of at least the minimum length.
`pmtc_cancel_id`		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.
`pmtc_payeribanrefund`	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.
`pmtc_canceldescription`		AN500	OPTIONAL. Cancel description for the refund that can be shown to the buyer.
`pmtc_cancelreason`		AN5	OPTIONAL. Cancel reason code. Reason for the refund that can be shown to the buyer. Possible values are: NOTDE - Order has not been delivered WSIZE - Item has wrong size INCOR - Item does not correspond to order DEFEC - Item is broken or defective OUTOF - Item is out of stock OTHER - Other reason
`pmtc_pay_with_reference`	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 (Finanssiala). 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

Input Name	Value	Format	C/O
`pmtc_action`	REFUND_AFTER_SETTLEMENT	AN6	C	Action called (REFUND_AFTER_SETTLEMENT).
`pmtc_version`	0005	AN4	C	Version of interface content or message.
`pmtc_sellerid`		AN15	C	Technical seller id given to the webstore by Svea Payments.
`pmtc_id`		AN20	C	Unique Payment Identifier given to the payment transaction by the webstore.
`pmtc_returncode`		AN2	C	Response code. Indicates success or failure. See below for the values and explanations of all the codes.
`pmtc_returntext`		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
`pmtc_pay_with_reference`	a Finnish reference number	N20	C	A Finnish reference number to be used when making the money transfer to Svea
`pmtc_pay_with_recipientname`	Svea Payments Oy	AN50	C	The recipient name to be used on the money transfer as the recipient: Svea Payments Oy
`pmtc_pay_with_amount`	e.g. 15,00	N17	C	The money transfer amount, e.g. 15,00. Usually the same as `pmtc_cancelamount`.
`pmtc_pay_with_iban`	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:
`errors`		N/A	O	Details of all the errors in the input message. An XML structure with root `errors` having multiple `error` elements below it. Each `error` element has attribute `type` with value `general` or `field`. In case of fields, there is also attribute `name` telling for example what input parameter the error is related to.

Response code values

Response code	Short Description	Description

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 `<errors>`
91	Duplicate detected	Payment cancellation failed, as this request was a duplicate based on the given unique identifier (`pmtc_cancel_id`)
99	Failed	Payment cancellation failed, reason specified in `<pmtc_returntext>`

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 API

Refund Payment After Settlement

Request (S2S HTTP POST)

The process has several steps:

Response (XML)

Response code values

Example Response