POST//////
Update the amount or status of a dispute on a credit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account from which to update a dispute. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
| dispute_token string Required | Unique identifier of the dispute to update. Send a GET request to /credit/accounts/{account_token}/disputes to retrieve existing credit account tokens.Allowable Values: Existing dispute token |
Request body
| Fields | Description |
|---|---|
| amount decimal Required | Updated amount of the dispute, based on the resolution. Allowable Values: Format: 0.00 |
| status string Required | Status of the dispute. - ACTIVE - The dispute is active and awaiting resolution.- REVERSED - The dispute has been reversed and is no longer active.- AH_WON - The account holder won the dispute.- AH_LOST - The account holder lost the dispute.Allowable Values: ACTIVE, REVERSED, AH_WON, AH_LOST, REFUNDED |
| notes string Optional | Additional information on the dispute update (for example, a reason for the dispute update). Allowable Values: 750 char max |
| token string Optional | Unique identifier of the dispute update. Allowable Values: 36 char max |
| source_created_time datetime Optional | Date and time when the dispute occurred. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| interest_adjustments array of objects Optional | List of interest adjustments and their effective times, if applicable. Note that this typically only applies for a cross-cycle activity, such as a dispute or payment. Allowable Values: Valid array of one or more interest_adjustments objects |
| interest_adjustments[].currency_code string Required | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| interest_adjustments[].effective_date datetime Required | Date and time when the dispute interest charge originally happened, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| interest_adjustments[].amount decimal Required | The fee amount. Allowable Values: - < 0 (Credit) - The dispute is initiated.- > 0 (Debit) - The dispute is lost. |
Sample request body
JSON
{
"amount": 500,
"status": "AH_WON"
}
Response body
| Fields | Description |
|---|---|
| amount decimal Returned | Amount of the updated dispute, based on the resolution. Allowable Values: Format: 0.00 |
| status string Returned | Status of the dispute. - ACTIVE - The dispute is active and awaiting resolution.- REVERSED - The dispute has been reversed and is no longer active.- AH_WON - The account holder won the dispute.- AH_LOST - The account holder lost the dispute.Allowable Values: ACTIVE, REVERSED, AH_WON, AH_LOST, REFUNDED |
| notes string Conditionally returned | Additional information on the dispute update (for example, a reason for the dispute update). Allowable Values: 750 char max |
| account_token string Returned | Unique identifier of the credit account on which the dispute was updated. Allowable Values: Existing account token |
| token string Returned | Unique identifier of the dispute update. Allowable Values: 36 char max |
| created_time datetime Returned | Date and time when the dispute update was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"amount": 500,
"status": "AH_WON",
"notes": "account holder evidence accepted",
"account_token": "my_account_token_12",
"token": "dispute_update_token1234",
"created_time": "2023-07-01T00:27:09Z"
}