> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Release payment hold

> Manually release a payment hold on a credit account.

POST/credit/accounts/\{account\_token}/payments/\{payment\_token}/releasehold

Manually release a payment hold on a credit account.

## URL path parameters

| Fields | Description |
| - | - |
| account\_token string  Required | Unique identifier of the credit account on which a payment hold is being released. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:**  Existing account token |
| payment\_token string  Required | Unique identifier of the payment currently on hold. Send a `GET` request to `/credit/accounts/{account_token}/payments` to retrieve existing payment tokens. **Allowable Values:**  Existing payment token |

## Response body

| Fields | Description |
| - | - |
| token string  Returned | Unique identifier of the payment. 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 payment is made. **Allowable Values:**  36 char max  Existing account token |
| method string  Returned | Method of payment. **Allowable Values:**  `ACH`, `CHECK`, `DEBIT`, `CASH` |
| payment\_source\_token string  Conditionally returned | Unique identifier of the payment source. Required for ACH payments. **Allowable Values:**  Existing payment source token |
| payment\_schedule\_token string  Conditionally returned | Unique identifier of the payment schedule. **Allowable Values:**  36 char max |
| amount decimal  Returned | Total amount of the payment. **Allowable Values:**  0 min |
| currency\_code string  Returned | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  `USD` |
| status string  Returned | Current status of the payment or refund. **Allowable Values:**  `INITIATED`, `PENDING`, `PROCESSING`, `SUBMITTED`, `CANCELLED`, `COMPLETED`, `RETURNED`, `REFUNDED`, `SYS_ERROR`, `ACH_ERROR` |
| description string  Returned | Description of the payment. **Allowable Values:**  255 char max |
| metadata string  Conditionally returned | Customer-defined additional information about the payment (for example, a check number). **Allowable Values:**  255 char max |
| hold\_days integer  Returned | After a payment completes, the number of days to hold the available credit on the account before increasing it. **Allowable Values:**  Any integer |
| hold\_end\_time datetime  Conditionally returned | Date and time when the available credit hold is released. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| is\_manually\_released boolean  Conditionally returned | Whether the available credit hold was manually released for this payment. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| on\_hold boolean  Conditionally returned | Whether the available credit is on hold for this payment. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| returned\_details object  Conditionally returned | Contains information on a returned payment. **Allowable Values:**  Existing `returned_details` object |
| returned\_details.**return\_code** string  Returned | Return code for the returned payment. For more, see [NACHA ACH return codes](https://www.marqeta.com/docs/developer-guides/ach-origination.md#_nacha_ach_return_codes). **Allowable Values:**  Valid return code |
| returned\_details.**return\_reason** string  Returned | Reason the payment was returned. For more, see [NACHA ACH return codes](https://www.marqeta.com/docs/developer-guides/ach-origination.md#_nacha_ach_return_codes). **Allowable Values:**  Valid return reason |
| refund\_details object  Conditionally returned | Contains details for a refund. **Allowable Values:**  Existing `refund_details` object |
| refund\_details.**method** string  Returned | Payment instrument used to issue the refund. **Allowable Values:**  `ACH`, `CHECK` |
| refund\_details.**description** string  Returned | Description of the refund. **Allowable Values:**  255 char max |
| refund\_details.**status** string  Returned | Current status of the refund. **Allowable Values:**  `INITIATED`, `PENDING`, `PROCESSING`, `SUBMITTED`, `CANCELLED`, `COMPLETED`, `RETURNED` |
| waive\_returned\_payment\_fee boolean  Conditionally returned | A value of `true` indicates that a returned payment fee should not be applied. The default value of this field is `false`. This field is only considered when transitioning the status of the fee to `REFUNDED`. **Allowable Values:**  `true`, `false` |
| created\_time datetime  Returned | Date and time when the payment was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| updated\_time datetime  Returned | Date and time when the payment was last updated on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| transitions array of objects  Returned | Contains one or more `transitions` objects, which contain information about a payment status transition. **Allowable Values:**  One or more `transitions` objects |
| transitions\[].**token** string  Returned | Unique identifier of the payment status transition. **Allowable Values:**  36 char max |
| transitions\[].**account\_token** string  Returned | Unique identifier of the credit account on which you want to transition a payment status. **Allowable Values:**  Existing account token |
| transitions\[].**payment\_token** string  Returned | Unique identifier of the payment whose status you want to transition. **Allowable Values:**  Existing payment token |
| transitions\[].**status** string  Returned | Current status of the payment or refund. **Allowable Values:**  `INITIATED`, `PENDING`, `PROCESSING`, `SUBMITTED`, `CANCELLED`, `COMPLETED`, `RETURNED`, `REFUNDED`, `SYS_ERROR`, `ACH_ERROR` |
| transitions\[].**created\_time** datetime  Conditionally returned | Date and time when the payment transition was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| allocations array of objects  Conditionally returned | List of objects that contain information about how a payment is allocated. **Allowable Values:**  List of payment allocations |
| allocations\[].**bucket** undefined  Returned | Category to which a portion of the payment is allocated. **Allowable Values:**  `PRINCIPAL`, `INTEREST`, `FEES`  36 char max |
| allocations\[].**amount** decimal  Returned | Total amount of the payment allocation. **Allowable Values:**  0 min |
| program\_migration\_time datetime  Conditionally returned | Date and time when the statement summary was migrated to Marqeta's credit platform, in UTC. The value of this field is `null` if it has not been migrated. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "token": "my_payment_25",
  "account_token": "my_account_token_12",
  "method": "CHECK",
  "amount": 25,
  "currency_code": "USD",
  "status": "COMPLETED",
  "description": "minimum payment",
  "metadata": "check_number123",
  "hold_days": 5,
  "hold_end_time": "2024-09-09T22:48:09.721Z",
  "is_manually_released": true,
  "on_hold": false,
  "created_time": "2024-09-09T22:42:35.065Z",
  "updated_time": "2024-09-09T22:48:09.722Z",
  "transitions": [
    {
      "token": "my_transition_token1234",
      "account_token": "account-12",
      "payment_token": "my_payment_25",
      "status": "COMPLETED",
      "created_time": "2024-09-09T22:42:35.068Z"
    }
  ]
}
```


## Related topics

- [About Credit Account Payments](https://www.marqeta.com/docs/developer-guides/about-credit-account-payments.md)
- [Payments Overview](https://www.marqeta.com/docs/core-api/credit-account-payments.md)
- [Platform Overview](https://www.marqeta.com/docs/developer-guides/platform-overview.md)
- [Release Notes](https://www.marqeta.com/docs/developer-guides/release-notes-2025.md)
- [2021 Release Notes](https://www.marqeta.com/docs/developer-guides/release-notes-2021.md)
