---
id: addintegrationid
title: Add IntegrationId
hide_title: true
description: "Add an Integration Id for a customer"
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import Flag from '../../../../../src/components/flag/flag';
import Ingress from '../../../../../src/components/ingress/ingress.react';

<Ingress title="Add IntegrationId">
This functionality is used to add IntegrationId's for a customer.
</Ingress>

This method is available in the following countries:
<Flag country="se" />
<Flag country="no" />
<Flag country="fi" />

## Parameters

| Field                    | min Occurs | nillable | Max | Type   | Description                                                                                                                                                                                                                                                                                                                                  |
| :----------------------- | :--------- | :------- | :-- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Username                 | 1          | false    | 50  | string | The username used to authorize the request.                                                                                                                                                                                                                                                                                                  |
| Password                 | 1          | false    | 50  | string | The password used to authorize the request.                                                                                                                                                                                                                                                                                                  |
| CorrelationId            | 1          | true     | 50  | string | CorrelationID is sent back in the response.                                                                                                                                                                                                                                                                                                  |
| CountryCode              | 1          | false    | 4   | string | The country code (ISO 3166-1 alpha-2) for the country.                                                                                                                                                                                                                                                                                       |
| IntegrationId            | 1          | true     | 50  | string | The integration ID can be assigned to customers in order to uniquely identify customers (instead of using Civic reg no). Civic reg. numbers can be used for this but are not mandatory - as long as the value entered is unique. No separators should be used, for example: - , . Only nillable if RegNo is set (usage of RegNo is standard) |
| IntegrationIdDescription | 1          | true     | 50  | string | A friendly description of the IntegrationId given. Shown on the invoice as the “buyer” instead of the IntegrationId value if used. Must be used in combination with IntegrationId. No separators should be used, for example: - , .                                                                                                          |
| RegNo                    | 1          | false    | 20  | string | The customer's registration number.                                                                                                                                                                                                                                                                                                          |
| StoreId                  | 1          | true     | 4   | int    | The StoreId used for identification of store.                                                                                                                                                                                                                                                                                                |

## Response

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

### Example Requests

| &nbsp;       | Value                                                              |
| :----------- | :----------------------------------------------------------------- |
| Environment: | UAT                                                                |
| Service:     | PaymentService                                                     |
| URL:         | https://ecommercetest.collector.se/v3.0/PaymentServiceV10.svc?wsdl |
| Function:    | AddIntegrationId                                                   |
| Description: | The operation adds integrationId to the specified customer         |
| Notes:       | N/A                                                                |

<Tabs defaultValue="reqB2C" values={[
{ label: 'B2C Request', value: 'reqB2C', },
{ label: 'B2C Response', value: 'resB2C', }]}>
<TabItem value="reqB2C">

```xml
<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>
   </soapenv:Header>
   <soapenv:Body>
      <pay:AddIntegrationIdRequest>
         <pay:CorrelationId>dcda57a3-fd45-47e7-9565-bf4c907e4977</pay:CorrelationId>
         <pay:CountryCode>SE</pay:CountryCode>
         <pay:IntegrationId>ID_123456</pay:IntegrationId>
         <pay:IntegrationIdDescription>Integration ID description</pay:IntegrationIdDescription>
         <pay:RegNo>195001182046 </pay:RegNo>
         <pay:StoreId>1234</pay:StoreId>
      </pay:AddIntegrationIdRequest>
   </soapenv:Body>
</soapenv:Envelope>

```

</TabItem>
<TabItem value="resB2C">

```xml

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <AddIntegrationIdResponse xmlns="http://schemas.ecommerce.collector.se/v30/PaymentService">
         <CorrelationId>dcda57a3-fd45-47e7-9565-bf4c907e4977</CorrelationId>
      </AddIntegrationIdResponse>
   </s:Body>
</s:Envelope>

```

</TabItem>
</Tabs>

### Error Codes

Please see separate page [Error Codes](/docs/paymentsApi/integration/error-codes)

| Fault Code | Description |
| :--------- | :---------- |