> For the complete documentation index, see [llms.txt](https://docs.calypso.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.calypso.money/get-started-with-calypso-ui/make-payments-via-ui/how-to-use-payments-with-confirmations.md).

# How to use payments with Confirmations

## Payout Confirmations

Payout confirmations add an extra review step before funds are sent. If confirmations are enabled, a created payout is not sent for processing immediately. It must first be confirmed by one or more users with the required permissions.

Confirmations can apply to payouts created both in the UI and through the API.

### When to Use Payout Confirmations

We recommend enabling payout confirmations if:

* payouts are created by multiple employees;
* payout creation and payout approval should be handled by different users;
* your company processes large payout amounts;
* you need additional control before funds are sent;
* payouts are created automatically through the API but require manual review.

### How to Enable Payout Confirmations

To enable payout confirmations:

1. Open your account dashboard.
2. Go to `Settings`.
3. Open the security settings or payout settings.
4. Find the payout confirmation setting.<br>
5. Enable confirmations for payouts.<br>
6. Set the number of confirmations required to send a payout.<br>
7. Save the changes.

After this setting is enabled, new payouts will require confirmation before processing.

> Section names in the UI may differ depending on your account configuration and user permissions.

### Who Can Confirm Payouts

Only users with the required company account permissions can confirm payouts.

The usual roles involved in the confirmation process are:

* a user who creates payouts;
* a user who reviews and confirms payouts;
* an administrator who manages settings and permissions.

If a user does not see the confirmation button, check their role and access permissions.

### Payout Created in the UI

To create a payout in the UI:

1. Open the `Payouts` section.
2. Click `Create payout`.
3. Select the currency and network.
4. Enter the recipient details.
5. Enter the amount.
6. Fill in any additional required fields.
7. Review the payout details.
8. Click `Create`.

If confirmations are disabled, the payout will be sent for processing immediately after creation.

If confirmations are enabled, the payout will be created with a pending confirmation status. Funds will not be sent to the recipient until the payout is confirmed.

### How to Confirm a Payout in the UI

To confirm a payout:

1. Open the `Payouts` section.
2. Find the payout waiting for confirmation.
3. Open the payout details.
4. Review the amount, currency, network, recipient address, and comment.
5. Click `Confirm`.
6. Confirm the action if the interface asks for additional confirmation.

After confirmation, one of the following happens:

* if this was the last required confirmation, the payout moves to processing;
* if more confirmations are required, the payout remains pending until other users add the missing confirmations.

### Payout Created Through the API

If confirmations are enabled, a payout created through the API may also require manual confirmation in the UI.

Typical flow:

1. The merchant creates a payout through the API.
2. The system accepts the request and creates the payout.
3. If confirmations are enabled for the account, the payout is not sent immediately.
4. The payout appears in the UI payout list with a pending confirmation status.
5. A user with the required permissions opens the payout and reviews the details.
6. The user confirms the payout in the UI.
7. After the required number of confirmations is reached, the payout moves to processing.

This flow is useful when payouts are created automatically, but the final decision to send funds must be made by a company employee.

### Confirmation Statuses

The UI may show a payout status that reflects the current confirmation stage.

Main statuses:

* `Created, not approved` — the payout has been created but has not been confirmed yet;
* `Created, partly approved` — the payout has received some confirmations, but not enough to proceed;
* `Confirmed` — the payout has received the required number of confirmations and can be sent for processing.

After confirmation, the payout continues through the standard payout lifecycle and may move to processing, successful completion, or failure statuses.

### If Multiple Confirmations Are Required

A company can configure a rule where more than one confirmation is required before a payout is sent.

For example, if two confirmations are required:

1. The first user creates a payout.
2. The second user confirms the payout.
3. If one confirmation is not enough, the payout remains pending.
4. A third user adds the second confirmation.
5. The payout then moves to processing.

The user who created the payout may be restricted from confirming their own payout if this limitation is enabled in the company settings.

### What to Check Before Confirming

Before confirming a payout, check:

* currency and network;
* payout amount;
* recipient address or payment details;
* fee, if displayed;
* comment or payout purpose;
* external ID, if the payout was created through the API;
* creation date and the user who created the payout.

Confirm a payout only if all details are correct.

### Canceling or Rejecting a Payout

If the payout details are incorrect, do not confirm it.

Depending on the UI configuration, a user may be able to:

* cancel the payout;
* reject the payout;
* ask the creator to create a new payout with correct details.

If the cancel or reject button is not available, contact your account administrator or support.

### Notifications and Webhooks

For payouts created through the API, merchants should consider that a payout may not move to processing immediately after creation.

If confirmations are enabled, the API may return a successful payout creation response, but the actual sending of funds starts only after confirmation.

We recommend building your integration so that the merchant system tracks final payout statuses instead of treating a payout as completed immediately after creation.

### FAQ

#### Why was the payout not sent after creation?

Most likely, payout confirmations are enabled for the account. Open the payout in the UI and check whether it is waiting for confirmation.

#### Why do I not see the confirmation button?

Possible reasons:

* the user does not have the required permissions;
* the payout has already been confirmed;
* the payout has been canceled or rejected;
* confirmation is not available for this payout type;
* the user is not allowed to confirm their own payouts.

#### Can API payouts be confirmed in the UI?

Yes. If a payout was created through the API and requires confirmation, it is displayed in the UI and can be confirmed by a user with the required permissions.

#### When will the funds be sent?

Funds are sent only after the payout receives the required number of confirmations and moves to processing.

#### Does every payout need to be confirmed?

If confirmations are enabled for payouts, every new payout that matches this rule must be confirmed before processing.

### Security Recommendations

* Separate users who create payouts from users who confirm payouts.
* Regularly review the list of users who can confirm payouts.
* Use multiple confirmations for large payouts.
* Check the recipient address before confirming a payout.
* Do not confirm payouts if any details look suspicious.
* Remove access for users who should no longer work with payouts.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.calypso.money/get-started-with-calypso-ui/make-payments-via-ui/how-to-use-payments-with-confirmations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.