---
id: creditinvoice
title: Credit Invoice
hide_title: true
description: "Crediting invoices"
---

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="Authorization">
Fully credits/returns the requested invoice.
</Ingress>

## 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.                                       |
| ClientIpAddress     | 1          | false    | 50  | string   | The IP address of the customer performing the purchase at the partner's web shop. |
| 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 the country.                            |
| InvoiceNumber       | 1          | false    | 50  | string   | The invoice number previously returned in AddInvoice.                             |
| CreditDate          | 1          | false    | -   | datetime | The date of the return.                                                           |
| SettlementReference | 1          | true     | 350 | string   | Settlement reference added to the return.                                         |
| StoreId             | 1          | true     | -   | 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:    | CreditInvoice                                                      |
| Description: | The operation fully credits/returns the requested invoice.         |
| 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:CreditInvoiceRequest>
         <pay:CorrelationId>CreditInvoiceV10</pay:CorrelationId>
         <pay:CountryCode>SE</pay:CountryCode>
         <pay:CreditDate>2020-04-21T15:06:58</pay:CreditDate>
         <pay:InvoiceNo>62396758</pay:InvoiceNo>
         <pay:SettlementReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
         <pay:StoreId>1234</pay:StoreId>
      </pay:CreditInvoiceRequest>
   </soapenv:Body>
</soapenv:Envelope>

```

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

```xml

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


```

</TabItem>
</Tabs>

### Error Codes

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

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