Credit Account Disputes
Use the credit account disputes endpoints to create and manage disputes on a credit account.
For more on disputes, see About Credit Account Disputes.
Creating a dispute triggers the creation of a journal entry belonging to the DISPUTE
group.
For more on dispute journal entries, see Disputes in the About Credit Account Journal Entries guide.
Create account dispute
Copy section link
Action: POST
Endpoint: /credit/accounts/{account_token}/disputes
Create a dispute of a journal entry on a credit account.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account for which to create a dispute. Send a Allowable Values: Existing account token |
Request body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the dispute. Allowable Values: 36 char max |
ledger_entry_token
string
|
Unique identifier of the journal entry ( Allowable Values: Existing |
amount
decimal
|
Amount of the dispute. Max value is equal to the value of the original transaction. Allowable Values: 0.01 min |
category
string
|
Category to which the dispute belongs. Allowable Values:
|
notes
string
|
Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
Response body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the dispute. Allowable Values: 36 char max |
ledger_entry_token
string
|
Unique identifier of the journal entry ( Allowable Values: Existing journal entry token |
account_token
string
|
Unique identifier of the credit account on which the dispute was created. Allowable Values: 36 char max Existing account token |
amount
decimal
|
Amount of the dispute. Allowable Values: Format: 0.00 |
status
string
|
Status of the dispute.
Allowable Values:
|
category
string
|
Category to which the dispute belongs. Allowable Values:
|
notes
string
|
Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
resolved_at
datetime
|
Date and time when the dispute was resolved and no longer in Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
updated_time
datetime
|
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
|
Date and time when the dispute was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
List account disputes
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/disputes
Retrieve an array of disputes on a credit account.
This endpoint supports sorting and pagination.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account for which to retrieve the disputes. Send a Allowable Values: Existing account token |
URL query parameters
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1–100 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: 0 min |
sort_by
string
|
Field on which to sort.
Prefix the field name with a hyphen ( NOTE:
You must sort using system field names such as Allowable Values:
|
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
Number of resources returned. Allowable Values: 1-10 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |
end_index
integer
|
Sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
data
array of objects
|
Contains one or more disputes on a credit account. Allowable Values: One or more dispute objects |
data[].token
string
|
Unique identifier of the dispute. Allowable Values: 36 char max |
data[].ledger_entry_token
string
|
Unique identifier of the journal entry ( Allowable Values: Existing journal entry token |
data[].account_token
string
|
Unique identifier of the credit account on which the dispute was created. Allowable Values: 36 char max Existing account token |
data[].amount
decimal
|
Amount of the dispute. Allowable Values: Format: 0.00 |
data[].status
string
|
Status of the dispute.
Allowable Values:
|
data[].category
string
|
Category to which the dispute belongs. Allowable Values:
|
data[].notes
string
|
Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
data[].resolved_at
datetime
|
Date and time when the dispute was resolved and no longer in Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].updated_time
datetime
|
Date and time when the dispute was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].created_time
datetime
|
Date and time when the dispute was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Retrieve account dispute
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/disputes/{dispute_token}
Retrieve a dispute from a credit account.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account from which to retrieve a dispute. Send a Allowable Values: Existing account token |
dispute_token
string
|
The unique identifier of the dispute to retrieve. Send a Allowable Values: Existing dispute token |
Response body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the dispute. Allowable Values: 36 char max |
ledger_entry_token
string
|
Unique identifier of the journal entry ( Allowable Values: Existing journal entry token |
account_token
string
|
Unique identifier of the credit account on which the dispute was created. Allowable Values: 36 char max Existing account token |
amount
decimal
|
Amount of the dispute. Allowable Values: Format: 0.00 |
status
string
|
Status of the dispute.
Allowable Values:
|
category
string
|
Category to which the dispute belongs. Allowable Values:
|
notes
string
|
Additional information on the dispute (for example, a reason for the dispute). Allowable Values: 750 char max |
resolved_at
datetime
|
Date and time when the dispute was resolved and no longer in Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
updated_time
datetime
|
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
|
Date and time when the dispute was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Update account dispute
Copy section link
Action: POST
Endpoint: /credit/accounts/{account_token}/disputes/{dispute_token}/transitions
Update the amount or status of a dispute on a credit account.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account from which to update a dispute. Send a Allowable Values: Existing account token |
dispute_token
string
|
The unique identifier of the dispute to update. Send a Allowable Values: Existing dispute token |
Request body
Copy section link
Fields | Description |
---|---|
amount
decimal
|
Updated amount of the dispute, based on the resolution. Allowable Values: Format: 0.00 |
status
string
|
Updated status of the dispute.
Allowable Values:
|
notes
string
|
Additional information on the dispute update (for example, a reason for the dispute update). Allowable Values: 750 char max |
token
string
|
Unique identifier of the dispute update. Allowable Values: 36 char max |
Response body
Copy section link
Fields | Description |
---|---|
amount
decimal
|
Amount of the updated dispute, based on the resolution. Allowable Values: Format: 0.00 |
status
string
|
Status of the updated dispute.
Allowable Values:
|
notes
string
|
Additional information on the dispute update (for example, a reason for the dispute update). Allowable Values: 750 char max |
account_token
string
|
Unique identifier of the credit account on which the dispute was updated. Allowable Values: Existing account token |
token
string
|
Unique identifier of the dispute update. Allowable Values: 36 char max |
created_time
datetime
|
Date and time when the dispute update was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |