Set Reservation

Creates a new or updates an existing reservation for the requested customer. This reservation is a fixed credit limit for the customer, allowing the customer to make purchases (AddInvoice) within the limit, without generating credit checks for each purchase.

If no existing reservation is found a credit check is performed, if successful a new reservation with the requested amount is created. If an existing reservation is found and the requested amount is higher a new credit check is/could be performed and if successful, the reservation amount will be increased. If an existing reservation is found and the requested amount is lower, the reserved amount will be decreased.

This functionality is only available in the following countries: Sweden, Norway, Finland and Denmark. The usage of this functionality must be agreed upon with Collector. Any purchases/invoices made before a reservation will be calculated into the AvailableAmount of the reservation.

This method is available in the following countries:

Parameters

Fieldmin OccursnillableMaxTypeDescription
Username1false50stringThe username usedf to authorize the request.
Password1false50stringThe password used to authorize the request.
ClientIpAddress1false50stringThe IP address of the customer performing the purchase at the partner's web shop.
AdditionalInformation[]1true-AdditionalInformation[]??
CompanyEmailAuthorizedSignatory1true100stringEmail to authorized signatory.
CompanyPersonalGuarantee1true-boleanReg. no for authorized signatory. If CompanyPersonalGuarantee is enabled, the reg. no in this parameter will be used as personal guarantee reg. no.
CompanyRegNoAuthorizedSignatory1true12stringReg. no for authorized signatory. If CompanyPersonalGuarantee is enabled, the reg. no in this parameter will be used as personal guarantee reg. no.
CorrelationId1false50stringCorrelationID is sent back in the response.
CountryCode1false2stringThe country code (ISO 3166-1 alpha-2) for the country. Only “SE” allowed.
CurrencyCode1false2stringThe ISO 4217 code representation for the currency.
CustomerAddress1true-Address[]The invoice address where the invoice should be sent to. For private persons this must be the address where the person is registered.
CustomerNumber1true20stringIf the e-store wants to search for a customer by their
own customer id, this field can be used to specify
that number. Also shown on invoice.
Email1true100stringCustomer's email address
IntegrationId1true128stringThe integration ID can be assigned to customers in order to uniquely identify customers (instead of using Civic reg no).
IntegrationId Description1true128stringA friendly description of the IntegrationId given. Shown on the invoice as the “buyer” instead of the IntegrationId value. Must be used in combination with IntegrationId. No separators should be used, for example: - , .
MobilePhone1true20stringThe customer's cellphone number. Must begin with “+” and country code e.g. +46.
PhoneNumber1true20stringThe customer's phone number
ProductCode1true20string
RegNo1true12stringThe customer civic registration number. Only nillable if an IntegrationId is set and has been assigned to the RegNo beforehand.
ReservedAmount1false6,2desimalThe requested amount to reserve. If an existing reservation is found that reservations amount will be increased or decreased to the amount you send in.
StoreId1false4stringThe StoreId used for identification of store.

Response

The response indicates if the customer is approved for the credit amount requested. If the purchase is approved, proceed with the purchase by invoking AddInvoice.

Fieldmin OccursnillableMaxTypeDescription
CorrelationId1true50stringCorrelationID from the request if any.
ReservedAmount1true6,2decimalTotal amount reserved.
AvailableAmount1true6,2decimalAvailable amount left on the reservation.
ValidUntil1true-datetimeDate until the reservation is valid, null means indefinite.
PendingUntil1true-datetimeThe date and time when a pending reservation will be removed if no activation of the reservation has been done. Only used when a reservation need to be activated with the ActivateReservation API. Null means the reservation don’t have a pending state (directly activated).
Status1true-stringReturns the handling status of a reservation, the status can be: PENDING = The reservation is still not active, must be activated with the ActivateReservation API. ACTIVE = The reservation is directly activated. NO_RESERVATION = There is no reservation. SIGNING = The reservation need to be signed, eg. by BankID.
ReservationId1true-stringThe reservation's unique id.
Address1True-AddressContains the address of the customer.

Reservation status

The reservation status type is an enumeration value. Defined values are:

  • ACTIVE (0) – The reservation is active and ready to be used.
  • PENDING (1) – The reservation is pending and need to be activated.
  • NO_RESERVATION (2) – There is no reservation.
  • SIGNING (3) – The reservation needs to be signed by end customer.

Example Requests

 Value
Environment:UAT
Service:PaymentService
URL:https://ecommercetest.collector.se/v3.0/PaymentServiceV10.svc?wsdl
Function:SetReservation
Description:The operation create a reservation for the customer
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:SetReservationRequest>
<pay:AdditionalInformation>
</pay:AdditionalInformation>
<pay:CompanyEmailAuthorizedSignatory xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:CompanyRegNoAuthorizedSignatory xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:CorrelationId>SetReservationV10</pay:CorrelationId>
<pay:CountryCode>SE</pay:CountryCode>
<pay:CurrencyCode>SEK</pay:CurrencyCode>
<pay:CustomerAddress>
<pay:Address1>Testgatan 1</pay:Address1>
<pay:Address2 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:COAddress>C/O Address</pay:COAddress>
<pay:City>Test CIty</pay:City>
<pay:CompanyName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:CountryCode>SE</pay:CountryCode>
<pay:Firstname>FirstName</pay:Firstname>
<pay:Lastname>LastName</pay:Lastname>
<pay:PostalCode>12345</pay:PostalCode>
</pay:CustomerAddress>
<pay:CustomerNumber xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:Email>test@collecotrobank.se</pay:Email>
<pay:IntegrationId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:IntegrationIdDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:MobilePhone>+461234567890</pay:MobilePhone>
<pay:PhoneNumber xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:ProductCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:RegNo>195109212224</pay:RegNo>
<pay:ReservedAmount>5000</pay:ReservedAmount>
<pay:StoreId>1234</pay:StoreId>
</pay:SetReservationRequest>
</soapenv:Body>
</soapenv:Envelope>
<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:SetReservationRequest>
<pay:AdditionalInformation>
</pay:AdditionalInformation>
<pay:CompanyEmailAuthorizedSignatory>person@company.com</pay:CompanyEmailAuthorizedSignatory>
<pay:CompanyPersonalGuarantee>true</pay:CompanyPersonalGuarantee>
<pay:CompanyRegNoAuthorizedSignatory>195109212224</pay:CompanyRegNoAuthorizedSignatory>
<pay:CorrelationId>SetReservationV10</pay:CorrelationId>
<pay:CountryCode>SE</pay:CountryCode>
<pay:CurrencyCode>SEK</pay:CurrencyCode>
<pay:CustomerAddress>
<pay:Address1>BOX 11914</pay:Address1>
<pay:Address2 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:COAddress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:City>Göteborg</pay:City>
<pay:CompanyName>Collector Bank AB</pay:CompanyName>
<pay:CountryCode>SE</pay:CountryCode>
<pay:Firstname xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:Lastname xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:PostalCode>40439</pay:PostalCode>
</pay:CustomerAddress>
<pay:CustomerNumber xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:Email>test@collecotrobank.se</pay:Email>
<pay:IntegrationId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:IntegrationIdDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:MobilePhone>+461234567890</pay:MobilePhone>
<pay:PhoneNumber xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:ProductCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<pay:RegNo>556597-0513</pay:RegNo>
<pay:ReservedAmount>5000</pay:ReservedAmount>
<pay:StoreId>9666</pay:StoreId>
</pay:SetReservationRequest>
</soapenv:Body>
</soapenv:Envelope>

Error codes

Please see separate page Error Codes

Fault CodeDescription
INVALID_REGISTRATION_NUMBER
PERSONAL_GUARANTEE_NOT_ENABLED