# Payment Change ###### After the checkout process has been finalized, the following actions can be performed: cancellation, return, credit/debit and add items to the shopping cart. ## Request Parameters ### `` Section | Parameter | Condition | Enumeration | | --- | --- | --- | | [`system-id`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/system-id) | Mandatory | | | [`transaction-id`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/transaction-id) | Mandatory | | | ​[`operation`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/operation)​ | Mandatory | `PAYMENT_CHANGE` | | ​[`operation@subtype`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/operation)​ | Mandatory | `cancellation``return``credit``change-order` | | ​[`credential`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/credential)​ | Mandatory | | | ​[`external`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/external)​ | Optional | | | ​[`meta`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/head/meta)​ | Optional | | ### `` Section The `` section of the **PAYMENT_CHANGE request** contains shopping basket data. | Parameter | Condition | Type | | --- | --- | --- | | [`customer`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/content/customer) | Optional since API version 1.7.5 | customerType | | [`shopping-basket`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/content/shopping-basket) | Mandatory | shoppingBasketType | | [`payment`](/docs/developer/api_integration/payment_1.8/payment_api_documentation/api_explorer/content/payment) | Optional since API version 1.7.5 | paymentType | With Gateway API version 1.8 and higher the content of the shopping basket consists of the items that are changed (cancelled, delivered, returned) – **except the PAYMENT_CHANGE change-order**. This operation **replaces** the open basket. ## Operation subtypes ### `cancellation` Customer/merchant **cancels** some or all items which are still pending for delivery. ```xml partial cancellation MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 Artikel C ``` ```xml full-cancellation MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 ``` ### `return` Customer returns some or all items which were already delivered. ```xml partial-return MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 Artikel A Rabatt ``` ```xml full-return MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 ``` ### `change-order` Customer/merchant **adds/removes** one or more items. **The operation completely replaces the open items.** This means that all open items have to be submitted. Items that are open before and not included at the change-order will be cancelled automatically. All Items that were subsequently added to the order also have to be delivered with a succeeding **CONFIRMATION_DELIVER**. "Financial" items added by a `credit` must not be delivered. ```xml MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 Article a Artikel B Artikel C Rabatt Versandkosten ``` ### `credit` Merchant adds one or more financial items representing **a credit or a debit** subsequently to the order **after** (1st) **delivery**. These items must not be delivered. ```xml MyTestsystem xx-xxxxxxxxxxxxxx PAYMENT_CHANGE INTEGRATION_TE_DACH 4c0a11923fa3433fb168f9c7176429e9 Kulanzgutschrift ``` ### Learn more More details on payment-changes including XML examples: [API: Payment-Change Logic](/docs/developer/api_integration/payment_1.8/payment_change_logic/) ## Response Parameters The **PAYMENT_CHANGE response** only contains payment data. ### `` Section | Parameter | Condition | Enumeration | | --- | --- | --- | | `system-id` | Mandatory | | | `transaction-id` | Mandatory | | | `operation` | Mandatory | | | `operation@subtype` | Mandatory | - `cancellation`- `return`- `credit`- `change-order` | | `response-type` | Mandatory | - success:`PAYMENT_PERMISSION`- failure:`STATUS_ERROR` | | `external` | Optional | | | `processing` | Mandatory | | ### `` Section | Parameter | Condition | | --- | --- | | `payment` | Optional since API version 1.7.5 |