Credit Information Service

Introduction

The Credit Information Service (CIS) is a web service provided by Avida Finans. The service checks one or more civic registration numbers (“personnummer”) for approved scoring against a specified scoring template. There are two available endpoints, one supporting WS-* and one supporting basicHttpBinding. Usually, you’ll want to use the WS-* if you’re developing in .NET, and the basicHttpBinding otherwise. Contact integration@avida.se if unsure.

Service overview

CIS checks if a collection of people have approved scoring. The service expects a single argument: a collection of the civic registration numbers (“personnummer”) of the people to check (as an array ofstrings). Each civic registration number must be 12 characters long and numeric. The service returns a collection of PersonScoring elements.
The PersonScoring element has the following structure:

   
                <Personscoring>
                    <CivicRegNumber>[The civig reg no., 12 characters]</CivicRegNumber>
                    <Scoringapproved>[true or false]</Scoringapproved>
                </Personscoring>
            
        

The value “true” mean that the scoring is approved and value “false” means that the scoring is not approved. If only one civic registration number need to be checked, enter a single value in a string array as input argument.

Service specification

Service method: ScoringApprovedWithAmount

Parameters:
1) Auth: An element to authenticate the user making the service call.
2) CivicRegNumbersWithAmount: An array of CivicRegNumbersWithAmount. CivicRegNumbermust be a string, amount must be a decimal. Each string must be 12 characters long and a valid Swedish civic registration number (“Personnummer”) without the dash, e.g. “196812200238”.
3) TemplateName: A string specifying the name of the template to use.

Parameter Auth

The Auth parameter defines an authentication object for calling an Avida web service.

Sample XML

    
                <Auth>
                    <Password>Test</Password>
                    <Username>Avida</Username>
                </Auth>
            
        

Parameter CivicRegNumbersWithAmount

The CivicRegNumbersWithAmount parameter defines an array of the input civic registration numbers with amount.

Sample XML

    
                <CivicRegNumberWithAmount>
                    <string>198006258688</string>
                    <decimal>3500</decimal>
                </CivicRegNumberWithAmount>
            
    

Parameter TemplateName

The TemplateName parameter defines the name of the scoring template to use. It must be a single string.

Service specification

Service method: ReserveAmount

Parameters:
1) Auth: An element to authenticate the user making the service call.
2) ReservationRequest: An array of ReservationRequest. ReservationRequest contains CivicRegNumber(string), DesiredAmount(decimal) and MinAmount(decimal).

Parameter Auth

The Auth parameter defines an authentication object for calling an Avida web service.

Parameter ReservationRequest

The ReservationRequest parameter defines an array of the input civic registration numbers with desired amount and minimum amount.

ApprovedAmount

The ApprovedAmount decimal is return value of ReservationRequest.

Test environment WS-*

WSDL URI
Endpoint URI

Production environment WS-*

WSDL URI
Endpoint URI

Test environment basicHttpBinding

WSDL URI
Endpoint URI

Production environment basicHttpBinding

WSDL URI
Endpoint URI

Contact

You can reach us at integration@avida.se


Back to Integration