Set Preferred Language

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

Parameters

Fieldmin OccursnillableMaxTypeDescription
ClientIpAddress1false50stringThe IP address of the customer performing the purchase at the partner's web shop.
Password1false50stringThe password used to authorize the request.
Username1false50stringThe username used to authorize the request.
CorrelationId1true50stringCorrelationID is sent back in the response.
CountryCode1false2stringThe country code (ISO 3166-1 alpha-2) for country.
LanguageCode1true5stringDesired customer notification language code (BCP-47). *
RegNo1true20stringThe registration number of the customer. Either civic registration number or organization number. Only nillable if an IntegrationId is set andhas been assigned to the RegNo beforehand.
StoreId1true4shortThe StoreId used for identification of store.

Supported language codes are:

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

Response

Fieldmin OccursnillableMaxTypeDescription
CorrelationID1true50stringCorrelationID 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 fetchs all reservations
Notes:N/A
<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>

Error codes

Please see separate page Error Codes

Fault CodeDescription
LANGUAGE_CODE_CHANGE_NOT_ALLOWED_FOR_PARTNERThe functionality to change preferred language is not set on merchant. Plase contact Collector.