POST////
Create a dispute of a journal entry on a credit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which to create a dispute. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the dispute. Allowable Values: 36 char max |
| ledger_entry_token string Required | Unique identifier of the journal entry (authorization.clearing type only) in dispute.Allowable Values: 36 char max Existing authorization.clearing type journal entry token |
| amount decimal Required | Amount of the dispute. Max value is equal to the value of the original transaction. Allowable Values: 0.01 min |
| category string Required | Category to which the dispute belongs. Allowable Values: FRAUD, AUTH, PROCESSING_ERROR, CONSUMER_DISPUTE |
| notes string Optional | Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
Sample request body
JSON
{
"token": "dispute_token_1234",
"ledger_entry_token": "journal_entry_token1222",
"amount": 500,
"category": "FRAUD"
}
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the dispute. Allowable Values: 36 char max |
| ledger_entry_token string Returned | Unique identifier of the journal entry (authorization.clearing type only) in dispute.Allowable Values: Existing journal entry token |
| account_token string Returned | Unique identifier of the credit account on which the dispute was created. Allowable Values: 36 char max Existing account token |
| amount decimal Returned | Amount of the dispute. 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 |
| category string Returned | Category to which the dispute belongs. Allowable Values: FRAUD, AUTH, PROCESSING_ERROR, CONSUMER_DISPUTE |
| notes string Conditionally returned | Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
| resolved_at datetime Conditionally returned | Date and time when the dispute was resolved and no longer in ACTIVE status.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Returned | Date and time when the dispute was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| created_time datetime Returned | Date and time when the dispute was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"token": "dispute_token_1234",
"ledger_entry_token": "journal_entry_token1222",
"account_token": "account_token_12",
"amount": 500,
"status": "ACTIVE",
"category": "FRAUD",
"notes": "fraudulent purchase",
"resolved_at": "2023-07-01T00:27:09Z",
"updated_time": "2023-07-01T00:27:09Z",
"created_time": "2023-07-01T00:27:09Z"
}