Set Preferred Language

This operation sets a preferred notification language for specified customer. The notification language affects the printed invoice.

Parameters

Field	min Occurs	nillable	Max	Type	Description
ClientIpAddress	1	false	50	string	The IP address of the customer performing the purchase at the partner's web shop.
Password	1	false	50	string	The password used to authorize the request.
Username	1	false	50	string	The username used to authorize the request.
CorrelationId	1	true	50	string	CorrelationID is sent back in the response.
CountryCode	1	false	2	string	The country code (ISO 3166-1 alpha-2) for country.
LanguageCode	1	true	5	string	Desired customer notification language code (BCP-47). *
RegNo	1	true	20	string	The registration number of the customer. Either civic registration number or organization number. Only nillable if an IntegrationId is set and has been assigned to the RegNo beforehand.
StoreId	1	true	4	short	The StoreId used for identification of store.

Supported language codes are:

• sv-SE
• sv-FI
• fi-FI
• en-GB

Response

Field	min Occurs	nillable	Max	Type	Description
CorrelationID	1	true	50	string	CorrelationID from the request if any.

Example Requests

	Value
Environment:	UAT
Service:	PaymentService
URL:	https://ecommercetest.collector.se/v3.0/PaymentServiceV10.svc?wsdl
Function:	setpreferredlanguage
Description:	The operation fetches all reservations
Notes:	N/A

B2C Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://schemas.ecommerce.collector.se/v30/PaymentService">
   <soapenv:Header>
      <pay:Username>USERNAME</pay:Username>
      <pay:Password>PASSWORD</pay:Password>
      <pay:ClientIpAddress>127.0.0.1</pay:ClientIpAddress>
   </soapenv:Header>
   <soapenv:Body>
      <pay:SetPreferredLanguageRequest>
         <pay:CorrelationId>SetPreferredLanguageV10</pay:CorrelationId>
         <pay:CountryCode>SE</pay:CountryCode>
         <pay:LanguageCode>sv-FI</pay:LanguageCode>
         <pay:RegNo>195001182046 </pay:RegNo>
         <pay:StoreId>1234</pay:StoreId>
      </pay:SetPreferredLanguageRequest>
   </soapenv:Body>
</soapenv:Envelope>

B2C Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <SetPreferredLanguageResponse xmlns="http://schemas.ecommerce.collector.se/v30/PaymentService">
         <CorrelationId>SetPreferredLanguageV10</CorrelationId>
      </SetPreferredLanguageResponse>
   </s:Body>
</s:Envelope>

Error codes

Please see separate page Error Codes

Fault Code	Description
LANGUAGE_CODE_CHANGE_NOT_ALLOWED_FOR_PARTNER	The functionality to change preferred language is not set on merchant. Plase contact Collector.