POST////
Create an adjustment for an existing credit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which you want to create an adjustment. 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 adjustment. Allowable Values: 36 char max |
| original_ledger_entry_token uuid Optional | 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 Optional | Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
| amount decimal Required | Amount of the adjustment. Value must be negative if original_ledger_entry_token is not passed.Allowable Values: 1000000 max |
| currency_code string Required | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| description string Required | Description of the adjustment. Allowable Values: 1–255 chars |
| note string Optional | Additional information on the adjustment. Allowable Values: 255 char max |
| reason string Optional | Reason for the adjustment. - DISPUTE - The adjustment occurred because a dispute was initiated.- DISPUTE_RESOLUTION - The adjustment occurred because of the result of a dispute resolution.- RETURNED_OR_CANCELED_PAYMENT - The adjustment occurred because a payment was returned or canceled.- OTHER - Any other reason the adjustment occurred. For example, a waived fee or account write-off.Allowable Values: DISPUTE, DISPUTE_RESOLUTION, RETURNED_OR_CANCELED_PAYMENT, OTHER |
Sample request body
JSON
{
"original_ledger_entry_token": "2384f927-e4fe-47af-8ff6-0712ee41a2eb",
"amount": -25,
"currency_code": "USD",
"description": "Waived late payment fee"
}
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the adjustment. If in the detail_object, unique identifier of the detail object.Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the credit account on which the adjustment was made. Allowable Values: 36 char max Existing account token |
| type string Returned | 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: PURCHASE, FEE, REWARD, INTEREST, GENERAL |
| original_ledger_entry_token uuid Conditionally returned | Unique identifier of the original journal entry needing the adjustment. Allowable Values: Existing journal entry token |
| external_adjustment_id uuid Conditionally returned | Unique identifier you provide of an associated external adjustment that exists outside Marqeta’s credit platform. Allowable Values: 255 char max |
| detail_token string Conditionally returned | 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 Conditionally returned | 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 detail_object fields marked “Returned for interest journal entries” in the account journal entry response fields.Disputes return dispute details. For the specific fields returned, see the dispute response fields. Allowable Values: Existing adjustment_detail_object |
| related_detail_token string Conditionally returned | 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 Conditionally returned | 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 related_detail_object |
| amount decimal Returned | Amount of the adjustment. Allowable Values: Format: 0.00 |
| currency_code string Returned | Valid three-digit ISO 4217 currency code. Allowable Values: USD |
| description string Returned | Description of the adjustment. Allowable Values: 1 char min |
| note string Conditionally returned | Additional information on the adjustment. Allowable Values: 255 char max |
| reason string Returned | Reason for the adjustment. - DISPUTE - The adjustment occurred because a dispute was initiated.- DISPUTE_RESOLUTION - The adjustment occurred because of the result of a dispute resolution.- RETURNED_OR_CANCELED_PAYMENT - The adjustment occurred because a payment was returned or canceled.- OTHER - Any other reason the adjustment occurred. For example, a waived fee.Allowable Values: DISPUTE, DISPUTE_RESOLUTION, RETURNED_OR_CANCELED_PAYMENT, OTHER |
| created_time datetime Conditionally returned | Date and time when the account adjustment was applied, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"token": "my_account_adjustment_token1234",
"account_token": "my_account_token_12",
"type": "FEE",
"original_ledger_entry_token": "a0216141-13d6-e2e2-7227-abcd12345678",
"external_adjustment_id": null,
"detail_token": null,
"adjustment_detail_object": null,
"related_detail_token": null,
"related_detail_object": null,
"amount": -25,
"currency_code": "USD",
"description": "Waived late payment fee",
"note": null,
"reason": "OTHER",
"created_time": "2025-04-01T23:41:58.802Z"
}