Adjustments
Use the adjustments endpoints to create and retrieve account adjustments on Marqeta’s credit platform. An account adjustment adjusts the amount of a journal entry or account balance.
Creating an adjustment triggers the creation of a journal entry belonging to the ADJUSTMENT
group.
For more on adjustment journal entries, see Adjustments in the About Credit Account Journal Entries guide.
Create account adjustment
Copy section link
Action: POST
Endpoint: /credit/accounts/{account_token}/adjustments
Create an adjustment for an existing credit account.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account for which you want to create an adjustment. Send a Allowable Values: Existing account token |
Request body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the adjustment. Allowable Values: 36 char max |
original_ledger_entry_token
uuid
|
Unique identifier of the original journal entry needing the adjustment. Required when adjusting an existing journal entry. Allowable Values: Existing journal entry token |
external_adjustment_id
uuid
|
Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
amount
decimal
|
Amount of the adjustment. Value must be negative if Allowable Values: 1000000 max |
currency_code
string
|
A valid three-digit ISO 4217 currency code Allowable Values:
|
description
string
|
Description of the adjustment. Allowable Values: 1–255 chars |
note
string
|
Additional information on the adjustment. Allowable Values: 255 char max |
reason
string
|
Reason for the adjustment.
Allowable Values:
|
Response body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the adjustment. If in the Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account on which the adjustment was made. Allowable Values: 36 char max Existing account token |
type
string
|
Type of adjustment. The adjustment is made on its correlating amount (for example, purchase adjustments are made on purchase amounts). You can use general adjustments for standalone adjustments made on the credit account balance itself, which includes account write-offs, credits, and more. Allowable Values:
|
original_ledger_entry_token
uuid
|
Unique identifier of the original journal entry needing the adjustment. Allowable Values: Existing journal entry token |
external_adjustment_id
uuid
|
Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
detail_token
string
|
Unique identifier of the adjustment detail. For example, the token of the dispute, the interest charge, or the returned payment that prompted the adjustment. Returned when the system automatically applies an adjustment. Allowable Values: 36 char max |
adjustment_detail_object
object
|
Contains the adjustment’s full details. The fields returned in this object depend on the adjustment type. Interest returns interest details.
For the specific fields returned, see the Disputes return dispute details. For the specific fields returned, see the dispute response fields. Allowable Values: Existing |
related_detail_token
string
|
Unique identifier of the dispute or returned payment that prompted the interest adjustment. This field is returned for interest adjustments only. Allowable Values: 36 char max |
related_detail_object
object
|
Contains full details of the related dispute or returned payment. The fields returned in this object depend on whether a dispute or returned payment led to the interest adjustment. A dispute returns dispute details; a returned payment returns payment details. For more on the dispute details returned, see the dispute response fields. For more on the returned payment details returned, see the payment response fields. This field is returned for interest adjustments only. Allowable Values: Existing |
amount
decimal
|
Amount of the adjustment. Allowable Values: Format: 0.00 |
currency_code
string
|
A valid three-digit ISO 4217 currency code Allowable Values:
|
description
string
|
Description of the adjustment. Allowable Values: 1 char min |
note
string
|
Additional information on the adjustment. Allowable Values: 255 char max |
reason
string
|
Reason for the adjustment.
Allowable Values:
|
created_time
datetime
|
Date and time when the account adjustment was applied, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
List account adjustments
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/adjustments
Retrieve an array of adjustments for a credit account.
This endpoint supports pagination.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account for which you want to retrieve adjustments. 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 |
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 account adjustments. Allowable Values: One or more account adjustment objects |
data[].token
string
|
Unique identifier of the adjustment. If in the Allowable Values: 36 char max |
data[].account_token
string
|
Unique identifier of the credit account on which the adjustment was made. Allowable Values: 36 char max Existing account token |
data[].type
string
|
Type of adjustment. The adjustment is made on its correlating amount (for example, purchase adjustments are made on purchase amounts). You can use general adjustments for standalone adjustments made on the credit account balance itself, which includes account write-offs, credits, and more. Allowable Values:
|
data[].original_ledger_entry_token
uuid
|
Unique identifier of the original journal entry needing the adjustment. Allowable Values: Existing journal entry token |
data[].external_adjustment_id
uuid
|
Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
data[].detail_token
string
|
Unique identifier of the adjustment detail. For example, the token of the dispute, the interest charge, or the returned payment that prompted the adjustment. Returned when the system automatically applies an adjustment. Allowable Values: 36 char max |
data[].adjustment_detail_object
object
|
Contains the adjustment’s full details. The fields returned in this object depend on the adjustment type. Interest returns interest details.
For the specific fields returned, see the Disputes return dispute details. For the specific fields returned, see the dispute response fields. Allowable Values: Existing |
data[].related_detail_token
string
|
Unique identifier of the dispute or returned payment that prompted the interest adjustment. This field is returned for interest adjustments only. Allowable Values: 36 char max |
data[].related_detail_object
object
|
Contains full details of the related dispute or returned payment. The fields returned in this object depend on whether a dispute or returned payment led to the interest adjustment. A dispute returns dispute details; a returned payment returns payment details. For more on the dispute details returned, see the dispute response fields. For more on the returned payment details returned, see the payment response fields. This field is returned for interest adjustments only. Allowable Values: Existing |
data[].amount
decimal
|
Amount of the adjustment. Allowable Values: Format: 0.00 |
data[].currency_code
string
|
A valid three-digit ISO 4217 currency code Allowable Values:
|
data[].description
string
|
Description of the adjustment. Allowable Values: 1 char min |
data[].note
string
|
Additional information on the adjustment. Allowable Values: 255 char max |
data[].reason
string
|
Reason for the adjustment.
Allowable Values:
|
data[].created_time
datetime
|
Date and time when the account adjustment was applied, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Retrieve account adjustment
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/adjustments/{adjustment_token}
Retrieve an adjustment for a credit account.
URL path parameters
Copy section link
Fields | Description |
---|---|
account_token
string
|
The unique identifier of the credit account for which you want to retrieve an adjustment. Send a Allowable Values: Existing account token |
adjustment_token
string
|
The unique identifier of the adjustment to retrieve. Send a Allowable Values: Existing adjustment token |
Response body
Copy section link
Fields | Description |
---|---|
token
string
|
Unique identifier of the adjustment. If in the Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account on which the adjustment was made. Allowable Values: 36 char max Existing account token |
type
string
|
Type of adjustment. The adjustment is made on its correlating amount (for example, purchase adjustments are made on purchase amounts). You can use general adjustments for standalone adjustments made on the credit account balance itself, which includes account write-offs, credits, and more. Allowable Values:
|
original_ledger_entry_token
uuid
|
Unique identifier of the original journal entry needing the adjustment. Allowable Values: Existing journal entry token |
external_adjustment_id
uuid
|
Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
detail_token
string
|
Unique identifier of the adjustment detail. For example, the token of the dispute, the interest charge, or the returned payment that prompted the adjustment. Returned when the system automatically applies an adjustment. Allowable Values: 36 char max |
adjustment_detail_object
object
|
Contains the adjustment’s full details. The fields returned in this object depend on the adjustment type. Interest returns interest details.
For the specific fields returned, see the Disputes return dispute details. For the specific fields returned, see the dispute response fields. Allowable Values: Existing |
related_detail_token
string
|
Unique identifier of the dispute or returned payment that prompted the interest adjustment. This field is returned for interest adjustments only. Allowable Values: 36 char max |
related_detail_object
object
|
Contains full details of the related dispute or returned payment. The fields returned in this object depend on whether a dispute or returned payment led to the interest adjustment. A dispute returns dispute details; a returned payment returns payment details. For more on the dispute details returned, see the dispute response fields. For more on the returned payment details returned, see the payment response fields. This field is returned for interest adjustments only. Allowable Values: Existing |
amount
decimal
|
Amount of the adjustment. Allowable Values: Format: 0.00 |
currency_code
string
|
A valid three-digit ISO 4217 currency code Allowable Values:
|
description
string
|
Description of the adjustment. Allowable Values: 1 char min |
note
string
|
Additional information on the adjustment. Allowable Values: 255 char max |
reason
string
|
Reason for the adjustment.
Allowable Values:
|
created_time
datetime
|
Date and time when the account adjustment was applied, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |