> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a batch of possibly associated transactions

> Submit a batch of possibly associated transactions to the VISA Network.

POST/cases/\{token}/associated\_transactions/selections

Submit a batch of possibly associated transactions to the VISA Network.

If the dispute case has any associated transactions, these are updated in the `associated_transactions` field for each transaction. If the submission is successful, the `network_submission_status` field is set to `SUBMITTED`.

You can globally set `credit_change_reason` and `auth_change_reason` values for all transactions included in the post. These values can be overridden for each associated transaction.

Each associated transaction is validated before submitting the batch to the network. If one associated transaction fails validation, the entire request fails. The failure occurs at the first violation, and the validation of the remaining payload is not validated. The response includes the list of affected associated transactions. If one of the potentially associated transactions has already been submitted to the network, an error is returned.

The response provides a list of transactions. Those with the associated field set to `true` are associated with the dispute case.

> [!CAUTION]
>
> **Warning**\
> Once an associated transaction selection form has been submitted, it cannot be resubmitted. The form can be updated.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | The dispute case token. **Allowable Values:**  36 char max |

## Body field details

| Fields | Description |
| - | - |
| network\_type string  Required | The card network. This should match the dispute case token provided in the path. **Allowable Values:**  `VISA` |
| credit\_change\_reason string  Optional | The credit change reason. This value is globally applied to all transactions in the list unless overridden by the `credit_change_reason` value for a specific transaction in the associated transaction object. Pattern: `^\d+$` **Allowable Values:**  A valid credit change reason. |
| auth\_change\_reason string  Optional | The auth change reason. This value is globally applied to all transactions in the list unless overridden by the `auth_change_reason` value for a specific transaction in the associated transaction object. Pattern: `^\d+$` **Allowable Values:**  A valid authorization change reason. |
| associated\_transactions array of objects  Required | An array of transactions associated with the current dispute case. Details for each transaction are defined in the `associated_transactions` object table. **Allowable Values:**  A valid array of [associated\_transaction](https://www.marqeta.com/docs/core-api/disputes-visa/associated-transactions/submit-batch-possibly-associated-transactions.md#_the_associated_transactions_object) objects. |

## The associated\_transactions object

| Fields | Description |
| - | - |
| associated boolean  Required | Indicates whether the transaction is associated with the given transaction. **Allowable Values:**  `true`, `false` |
| associated\_transaction\_token string  Required | The unique identifier for the associated transaction. **Allowable Values:**  A valid associated transaction token. |
| credit\_change\_reason string  Optional | The credit change reason for the specific associated transaction. This value overrides the `credit_change_reason` global value. Pattern: `^\d+$` **Allowable Values:**  A valid credit change reason. |
| auth\_change\_reason string  Optional | The auth change reason for the specific associated transaction. This value overrides the `auth_change_reason` global value. **Allowable Values:**  A valid authorization change reason. |

## Associated transactions response

A response is generated when all transactions included in the request have been submitted to the network. A `200` response code is generated with the following fields:

| Fields | Description |
| - | - |
| network\_type string  Returned | The card network. This matches the dispute case token provided in the path. **Allowable Values:**  `VISA` |
| token string  Returned | Unique identifier of the associated transaction on the Marqeta platform. **Allowable Values:**  36 char max |
| case\_token string  Returned | Token that indicates which dispute case this Associated Transaction belongs to. **Allowable Values:**  36 char max |
| network\_phase string  Returned | The network dispute state. **Allowable Values:**  `DISPUTE` |
| transaction\_date datetime  Returned | The date and time of the transaction. **Allowable Values:**  Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| transaction\_amount number  Returned | The amount of money associated with this transaction. **Allowable Values:**  A valid transaction amount. |
| transaction\_currency string  Returned | Three-digit ISO 3166-1 numeric code for the currency used in the transaction. **Allowable Values:**  30 char max |
| merchant\_name string  Returned | The name of the merchant associated with this transaction. **Allowable Values:**  22 char max |
| network\_submission\_status string  Returned | The status of the associated transaction on the network. **Allowable Values:**  `PENDING`—The initial value before the associated transaction is submitted to the network.  `SUBMISSION_FAILED`—The submission of the associated transaction to the network failed.  `SUBMITTED`—The associated transaction was successfully submitted to the network.  `UPDATE_FAILED`—The update to the associated transaction failed. |
| first\_network\_submission\_time datetime  Returned | The date and time when the associated transaction was first submitted to the network. **Allowable Values:**  Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| last\_network\_submission\_time datetime  Returned | The date and time when the associated transaction was updated at the network. This value is updated every time the associated transaction is updated to the network. **Allowable Values:**  Format: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| transaction\_type string  Returned | Visa-specific transaction type (for network use only). **Allowable Values:**  255 char max |
| auth\_code string  Returned | Visa-specific authorization code (for network use only). **Allowable Values:** |
| network\_selection\_form object  Returned | Visa-specific network selection form, containing the `credit_change_reason` and `auth_change_reason` code values that were set during the associated transaction selection in the `POST` or `PUT` request. These values are overwritten whenever an attempt is made to update the selection. **Allowable Values:**  See [The network\_selection\_form object](https://www.marqeta.com/docs/core-api/disputes-visa/associated-transactions/submit-batch-possibly-associated-transactions.md#_the_network_selection_form_object). |

## The network\_selection\_form object

| Fields | Description |
| - | - |
| associated boolean  Returned | Indicates whether the transaction is associated with the dispute case. This field is set once the selection is submitted. If `true`, the transaction is associated with the dispute case. **Allowable Values:**  `True`, `False` |
| credit\_change\_reason string  Returned | The credit change reason. Pattern: `^\d+$` **Allowable Values:**  A valid credit change reason code. |
| auth\_change\_reason string  Returned | The authorization change reason. Pattern: `^\d+$` **Allowable Values:**  A valid auth change reason code. |

## Submission errors

| Error Code | Description |
| - | - |
| 400 | Indicates one of the following has occurred: One of the associated transaction forms was already submitted. A `network_type` value does not match the one for the dispute. One of the associated transaction forms has a missing required field. |
| 404 | Indicates one of the following has occurred: The dispute case token was not found. One of the associated transactions was not found. The user attempts to submit a form for a dispute case that doesn't belong to the specified program short code. One of the associated transactions does not belong to the dispute case. |

## Sample request body

```json JSON lines wrap theme={null}
"network_type": "VISA",
  "credit_change_reason": "8",
  "auth_change_reason": "83952347647997785959177943288119589987930259773787787402577751279976256354634112680576",
  "associated_transactions": [
    {
      "associated": true,
      "associated_transaction_token": "string",
      "credit_change_reason": "31320146819959147412182438616152094955519754833",
      "auth_change_reason": "19825646390525201297707582594987938135506677612006399332111987193044"
    }
  ]
}
```

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "associated_transactions": [
    {
      "network_type": "VISA",
      "token": "string",
      "case_token": "string",
      "network_phase": "DISPUTE",
      "transaction_date": "2022-07-21T20:05:19.469Z",
      "transaction_amount": 0,
      "transaction_currency": "string",
      "merchant_name": "string",
      "network_submission_status": "PENDING",
      "first_network_submission_time": "2022-07-21T20:05:19.469Z",
      "last_network_submission_time": "2022-07-21T20:05:19.469Z",
      "transaction_type": "string",
      "auth_code": "string",
      "network_selection_form": {
        "associated": true,
        "credit_change_reason": "1931821026291098997994936518692286249429118358411883813460319553290652759495697632223762249903373317",
        "auth_change_reason": "88807041187533992807677186332619"
      }
    }
  ]
}
```


## Related topics

- [Associated Transactions (Visa) Overview](https://www.marqeta.com/docs/core-api/disputes-visa/associated-transactions.md)
- [Disputes (Visa) Overview](https://www.marqeta.com/docs/core-api/disputes-visa.md)
- [2021 Release Notes](https://www.marqeta.com/docs/developer-guides/release-notes-2021.md)
- [Managing Visa Disputes](https://www.marqeta.com/docs/developer-guides/managing-visa-disputes.md)
- [Update submitted associated transactions](https://www.marqeta.com/docs/core-api/disputes-visa/associated-transactions/update-submitted-associated-transactions.md)
