# Configure transaction freeze controls

Transaction freeze controls let you hold funds in place for compliance review, risk management, or regulatory purposes. You can freeze individual transactions or enable automatic freeze on a wallet so that Ripple Custody (Wallet) freezes all incoming deposits by default.

For the console procedures, see [Freeze and unfreeze transactions via the console](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions). For the API procedures, see [Freeze and unfreeze transactions via the API](/pt-br/products/wallet/compliance/transaction-freeze-api).

## Freeze actions

| Action | Console role | Console procedure | API procedure |
|  --- | --- | --- | --- |
| Freeze deposits by default | Owner, Administrator, Proposer | [Enable automatic freeze on a wallet](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions#enable-automatic-freeze-on-a-wallet-via-the-console) | [Update wallet settings](/pt-br/products/wallet/vaults-and-wallets/wallets/manage-wallets-api#update-wallet-settings-via-the-api) |
| Freeze a transaction | Owner, Administrator, Auditor | [Freeze an individual transaction](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions#freeze-an-individual-transaction-via-the-console) | [Freeze a transaction](/pt-br/products/wallet/compliance/transaction-freeze-api#freeze-a-transaction-via-the-api) |
| Unfreeze a transaction | Owner, Administrator, Auditor | [Unfreeze a transaction](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions#unfreeze-a-transaction-via-the-console) | [Unfreeze a transaction](/pt-br/products/wallet/compliance/transaction-freeze-api#unfreeze-a-transaction-via-the-api) |
| Check frozen funds | All roles | [Monitor frozen balances](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions#monitor-frozen-balances-via-the-console) | [Check freeze state](/pt-br/products/wallet/compliance/transaction-freeze-api#check-freeze-state-via-the-api) |


**Permissions:** In the console, owners, administrators, and auditors can freeze and unfreeze transactions. Owners, administrators, and proposers can turn on freeze by default, which is a wallet setting. See [User roles and permissions](/pt-br/products/wallet/organization-and-access/users-and-roles#transactions). Freezing and unfreezing through the API needs an API credential of type `TRANSACTIONS`. Changing wallet settings through the API needs a `WALLETS` credential.

## How freeze controls work

When you freeze a transaction, the funds remain in the wallet but move from the **available balance** to the **frozen balance**. Users can't spend, transfer, or include frozen funds in outgoing transactions until you unfreeze them.

The wallet's balance view shows:

| Balance type | Description |
|  --- | --- |
| **Available balance** | Funds available for outgoing transactions |
| **Frozen balance** | Funds held in a frozen state — visible but not spendable |
| **Pending balance** | Incoming funds that Ripple Custody (Wallet) hasn't yet released to the available balance or frozen |


Each frozen transaction records why it was frozen, and manual decisions take precedence over automatic ones. See [Freeze types and who can change them](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions#freeze-types-and-who-can-change-them).

## Compliance use cases

Freeze controls support a range of compliance and risk management scenarios:

- **AML/sanctions screening** — freeze incoming deposits until your compliance team completes screening checks.
- **Suspicious activity investigation** — freeze a transaction while you investigate unusual activity on a wallet.
- **Regulatory holds** — place a hold on funds in response to a regulatory request or legal order.
- **Audit trail** — Ripple Custody (Wallet) records every freeze and unfreeze action with the user, timestamp, and reason. Use [audit logging](/pt-br/products/wallet/integrations-and-monitoring/audit-logging) to export this data for compliance reporting.


Pair with approval groups
For additional governance, set up a transaction approval group so that outgoing transactions require human approval. Freeze controls govern incoming funds; approval groups govern outgoing funds. Together, they provide end-to-end oversight. See [Configure approval flows](/pt-br/products/wallet/governance-and-controls/approvals/configure-approval-flows).

## Related documentation

- [Freeze and unfreeze transactions via the console](/pt-br/products/wallet/compliance/freeze-and-unfreeze-transactions) — Enable automatic freeze, freeze and unfreeze transactions, and monitor frozen balances in the console
- [View and track transactions](/pt-br/products/wallet/transactions/view-and-track-transactions#view-a-transaction-via-the-console) — Find a transaction and open its transaction page
- [Receive assets](/pt-br/products/wallet/transactions/receive-assets) — How deposits appear, including frozen deposits
- [Manage wallets](/pt-br/products/wallet/vaults-and-wallets/wallets/manage-wallets) — Enable automatic freeze in wallet settings
- [Audit logging](/pt-br/products/wallet/integrations-and-monitoring/audit-logging) — Track freeze and unfreeze activity
- [Freeze and unfreeze transactions via the API](/pt-br/products/wallet/compliance/transaction-freeze-api) — Freeze, unfreeze, and check freeze state programmatically