> Documentation index: https://www.xekta.com/llms.txt

# cart_approve

> Ask the buyer to approve the cart at its current total.

This tool asks; it does not approve. The answer comes from the buyer, outside the assistant's conversation. See [Approval](https://www.xekta.com/docs/approval.md).

| | |
| - | - |
| Type | Write: changes a cart or an order |
| Needs a cart the buyer approved | No |
| Moves money | No |

**Tool description (what the assistant sees)**

```text
Requests the buyer's approval for a cart at its current total; the approval itself can only come from the buyer. Depending on the client, the buyer answers in a confirmation box the client shows, in an approval box XEKTA draws inside the chat, or on a secure XEKTA web page with their own sign-in (always used for totals over $200). Returns status approved, refused, approval_requested (with approval_url) or approval_box_open. total_cents is checked against the cart's current total and a mismatch is rejected. fallback: "link" returns the web-page link instead of a box. Any later change to the cart clears the approval, and checkout is refused for a cart without one.
```

## Parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `cart_id` | `uuid` | Yes | The cart. |
| `total_cents` | `integer` | Yes | The cart's current total in cents, as read from `cart_get`. A mismatch is rejected. |
| `fallback` | `string` | No | `link` returns the approval page link instead of a box. Use it only when the buyer says they see no box. |

## Notes

- Read the returned `status`: `approved`, `refused`, `approval_box_open`, `approval_requested`, or `confirm_in_assistant` on assistants such as Meta Muse. [Approval](https://www.xekta.com/docs/approval#the-statuses) says what to do for each.
- After `refused`, stop. Do not ask again for the same cart unless the buyer asks you to.

## What to call next

[`checkout_create`](https://www.xekta.com/docs/tools/checkout-create.md), only after the status is `approved`.