Submit a batch of possibly associated transactions

POST////

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.

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 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.

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

"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

{
  "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"
      }
    }
  ]
}

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

Submit a batch of possibly associated transactions

URL path parameters

Body field details

The associated_transactions object

Associated transactions response

The network_selection_form object

Submission errors

Sample request body

Sample response body

​URL path parameters

​Body field details

​The associated_transactions object

​Associated transactions response

​The network_selection_form object

​Submission errors

​Sample request body

​Sample response body

URL path parameters

Body field details

The associated_transactions object

Associated transactions response

The network_selection_form object

Submission errors

Sample request body

Sample response body