Skip to the article
Browse all docs

How does an AI assistant move money in Tacey, and what do I have to confirm?

The six money tools an AI assistant can use in Tacey: which three move money, which three only record that you handled it, and the amount you must type back, the 5-minute preview and the 24-hour permission each one needs.

Odera Joseph, FounderWritten by Odera JosephFounderUpdated
View as Markdown
Ask AI

Send the Markdown address of this page to an assistant.

Open in ChatGPTOpen in PerplexityOpen in Grok

An assistant such as ChatGPT or Claude can refund a customer, capture a payment you were holding, or note that you handled a balance yourself, but only when every one of the conditions below is true at the same moment. No money moves because an assistant decided it should. You approve an exact amount, in the chat, and Tacey checks that figure against Shopify before it sends anything.

In short

ToolWhat it doesMoves money?What you confirm
approve_refundRefunds money Tacey is holding for you to approve: a cancelled order's refund, or the refund after a customer's edit lowered the orderYes, a refund to the original payment method or store creditType back the exact amount and currency the preview named. A refund that includes shipping or duty is two refunds: type both, joined by a plus sign, for example 18.00 EUR + 4.50 EUR, never the total
confirm_merge_shipping_refundRefunds the duplicate shipping that merging two orders created, on the merged order Tacey is holding it forYes, a refund. Tacey also emails the customer its usual refund noticeType back the one amount and currency the preview named
capture_paymentCaptures a payment Shopify is already holding on one order now, instead of waiting for the edit window to endYes, it collects the held payment. It ends the customer's edit windowType back the exact amount and currency the preview named
record_manual_refundRecords that you already refunded a held refund by hand in Shopify, where the refund also covers shipping or dutyNoNothing to type. Tacey looks for the refund in Shopify and records it only if it is there
resolve_cancel_refundRecords that you checked, in Shopify, a cancelled order's refund that Tacey could not match to the cancelNoNothing to type
acknowledge_swap_balanceRecords that you handled, in Shopify, the balance a product swap left on an orderNoNothing to type

The first step of every money action is prepare_order_action. It is a preview. It moves no money and records nothing. It tells you what Tacey's own records show for the order: the amount, the currency, who owes whom and whether the amount is confirmed. If you have given the assistant the money permission and switched that action on, it also returns the exact amount Shopify shows now and where it would go, valid for 5 minutes. Otherwise it tells you why you approve in Tacey instead.

Before you start

All of these must be true. If one is not, the money tool is not listed for the assistant at all.

  1. The platform's money switch is on. It is separate from the switch for ordinary changes. On a live store, the money switch is off today, so on a live store the assistant cannot move money and the tools above are not offered. Money actions are available only on development stores for now. You can still approve every one of these steps yourself in Tacey.
  2. The ordinary change switch is on. Money tools also need AI changes to be available.
  3. You gave the connection the money permission, and it is less than 24 hours old. The permission ends after 24 hours. After that the assistant is told the money permission has ended, and you give it again.

Money permission is checked once, when it is approved. Tacey asks Shopify whether the person approving may refund orders only at that moment. It does not ask again. If that person loses refund permission or leaves your store, the permission keeps working until the 24 hours are up or until you disconnect the assistant, whichever comes first. It can never move more than the limit that person typed, you can turn money off in Tacey at any time (the next request is refused), and Disconnect ends it on the next request. If a teammate who approved money leaves, disconnect their assistant.

  1. You set a limit when you connected the assistant. The approval screen asks for a spending limit in your store's currency. Tacey acts only within that limit, and a limit of zero means no money permission at all.
  2. The action's own switch is on under Integrations in Tacey. The actions are listed under the master switch "Let assistants move money", which is off until you turn it on, and each action's own switch is off until you turn it on too.
  3. The connection is your own connector. The read-only directory version never lists money tools.
  4. The store's currency has not changed since you gave the permission, and the master switch "Let assistants move money" is still on.
  5. You are within the count limits. Each action also has a limit on how many times it can run. The starting limits are 3 an hour and 10 a day for approve_refund, capture_payment and confirm_merge_shipping_refund, and 10 an hour and 20 a day for the three that only record that you handled it. Under Integrations you can change the daily limit of an action.

How it works for a refund

  1. You ask the assistant, for example, "refund the held refund on order 1042".
  2. It runs prepare_order_action for that order and shows you the amount and where it would go.
  3. You type the amount and currency back exactly as shown. For a refund of two parts, type both parts in the order shown.
  4. Tacey compares what you typed with the figure Shopify shows right now. A different amount, a total, one figure of two or the wrong order is refused before anything is used.
  5. If Shopify still shows the same amounts and they are within your limit, Tacey sends each refund once, to the place the preview named. The order, the amounts and the destination come from Shopify and Tacey's records, never from the assistant.
  6. The assistant tells you what was refunded and where, and what Shopify shows owed afterwards, with a link to the order in Tacey. The refund is also written to the order's change history like any other.

capture_payment follows the same steps. The amount is the lesser of what Shopify is holding and the order's current total, and Tacey never charges a customer's saved card.

What you will see

  • A preview with the amount, currency and destination, valid for 5 minutes, usable once.
  • After you confirm: what was refunded or captured, and what Shopify shows owed afterwards.
  • On the order's change history in Tacey: the money row, the same as when you press the button yourself.
  • If the amount moved between the preview and your confirmation, nothing is sent and the new figure is shown.

If it does not work

The money tools are not offered at all. The platform money switch is off, you are on the read-only directory connector, the 24-hour money permission has ended or was never given, the master switch "Let assistants move money" or the action's own switch is off, or the store's currency changed after you gave the permission. On a live store the platform switch is off today, so use the button in Tacey instead.

"The amount does not match." You typed a different amount, a total, one figure of a two-part refund, or the figures in the wrong order. Ask for a new preview and type the figures exactly as written.

"The preview expired." A money preview lasts 5 minutes and works once. Ask again.

"The money permission has ended." The permission lasts 24 hours. Give it again when you reconnect.

capture_payment refused my order. Tacey refuses, in words, a cancelled order, a payment already captured or expired, an order placed while delayed capture was off, and a lowered order on a payment provider whose unused hold Tacey cannot release. Where it can, it gives the exact amount for you to capture by hand in Shopify.

A refund of two parts may have gone halfway. Tacey says so. Check the order's refunds in Shopify before you ask for another preview, so the customer is not refunded twice.

A refund needs a decision. A refund Tacey cannot explain from Shopify's quote is left for you to handle in Tacey. The assistant does not guess.

Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app. Tell us the order number, the tool name, and the exact message the assistant showed.

Learn more

What this does not do

  • It does not move money without an amount you typed back, a 5-minute preview, a permission under 24 hours old and a limit you set.
  • It does not choose the amount, the order or the destination. Those come from Shopify and Tacey's records.
  • record_manual_refund, resolve_cancel_refund and acknowledge_swap_balance refund, charge, capture and email nothing. They only note that you handled it.
  • It does not charge a customer's saved card.
  • It does not work on a store where the platform money switch is off.

Was this helpful?

One tap tells us whether this article did its job.

For AI agents: this article as markdownthe whole help centerllms.txt