Skip to the article

How does Tacey keep payment holds and money records up to date in the background?

Three automatic jobs that never move money: the payment hold release (payment_due_backstop), the sweep of money still waiting (open_money) and the settling of a merged order's shipping refund (combine_refund_settle). When they run, what they decide, what you see, and what to do when a hold, tag or refund label looks stuck.

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

Shopify tells Tacey when money moves on an order, but a message can be late, lost, or arrive while Shopify is busy. Three background jobs make sure Tacey's record, the hold on the order and the tags on the order catch up anyway. None of them charges a customer, and none of them sends a refund. They read Shopify, and then fix Tacey's own record or release a hold that has no reason left.

JobPlain wordsRunsLimit per run
payment_due_backstopReleases the payment hold when the customer owes nothing any moreEvery 15 minutes50 orders
open_moneyRe-reads orders that still show money waiting and corrects Tacey's recordEvery 15 minutes12 orders
combine_refund_settleSettles a merged order's shipping refund whose send did not report backEvery 15 minutes25 records

Releasing the payment hold (payment_due_backstop)

Why there is a hold

When a customer's change leaves a balance to pay, for example an added product or a faster shipping method, Tacey holds the order's fulfilment in Shopify so it does not ship unpaid. The hold shows in Shopify with the reason Awaiting payment, and the order carries the tag tacey-payment-owed. See How do I stop an order shipping while the customer can still edit it? for the hold itself.

The hold has one reason: the customer owes money. The moment Shopify says nothing is owed, that reason is gone and the hold should come off, however the balance got to zero.

What the job does

Shopify normally tells Tacey straight away when a payment arrives, and the hold is released then. This job is the guarantee behind that message. Every 15 minutes it takes up to 50 orders that still have an open payment hold, plus up to 50 older orders that were left with a record Tacey should have closed, and asks Shopify for each order's live balance. Then:

What Shopify saysWhat Tacey does
Still owes money, the order is not cancelledNothing. The hold stays on.
Cannot be read right now (a throttle, a short outage)Nothing. The hold stays on. Tacey asks again at the next run.
Nothing owed, and a real payment is on the orderThe change is recorded as paid, with the amount, the hold is released and the tacey-payment-owed tag is removed
Nothing owed, but no payment was made (for example you lowered the price, or the customer was credited)The unpaid change is marked Payment was never completed (Not collected in the ledger), the hold is released and the tag is removed. Tacey's team is alerted, and you are emailed that the payment was not completed when that email is on in Notifications, unless the customer took the unpaid item off themselves
The order was cancelledThe owed amount is closed as Not collected, no money moves, and the tag is removed. A cancelled order owes the store nothing
The customer owes you nothing, and Shopify now shows money owed back to themThe hold is released and the refund owed is recorded. This job sends no refund; the refund follows your refund settings and your approval
The card's payment is authorised and still waiting to be capturedThe hold is released, nothing is written as paid or as unpaid, the tacey-payment-owed tag stays on, and your own capture later settles the row and removes the tag

A hold is released only when it is Tacey's own. A hold you placed yourself in Shopify, or one another app placed, is never touched.

How to tell it ran

Open the order in Shopify. The hold is gone from its fulfilment and tacey-payment-owed is gone from its tags (when a card payment is authorised and still waiting to be captured, the hold is gone but the tag stays until the capture). In Tacey, the money label in Order changes has moved on from Payment not completed yet to the amount that was paid, or to Payment was never completed. See What do the money labels mean?.

What can stop it

  • The store has uninstalled Tacey. The order's rows are closed by a different sweep.
  • The order still owes money. The hold correctly stays. Tacey never releases an order that still owes you money. It waits until the customer pays, the balance is zero, the order is cancelled, or you release the hold in Shopify.
  • Shopify did not answer. The order is asked again at the next run.
  • Two checks for one order in one run. The hold-deadline check runs first, and this job starts after it has finished, so the two never release the same order at the same moment.

Settling money that is still waiting (open_money)

What it does

Shopify sends a message when a refund is made or a payment arrives. Tacey records that it received the message before it finishes fixing its own record. If the fixing step then fails, for example because Shopify was throttling, Shopify's later resend is treated as a duplicate and ignored. This job is the retry.

Every 15 minutes it takes up to 12 orders that still hold an open money record from the last 90 days: a refund owed to a customer, a balance owed by a customer, or a payment waiting. For each order it asks Shopify for the live balance and the live payments and refunds, once, and then settles each open record only when Shopify proves it.

A few rules it keeps:

  • One refund settles one record. Two records of 57.00 are not both closed by one 57.00 refund.
  • A smaller refund does not close a bigger owed amount. A partial refund leaves the record open and writes Shopify's remaining figure on it.
  • A cleared balance alone is not payment. A real payment on the order must exist before a record is marked paid.
  • A refund Tacey sent is not counted as one you made by hand.
  • Records older than 90 days are left for the daily check and a person, not this job.

When the last open record on an order in one direction is settled, the tag comes off that order: tacey-refund-owed when nothing is owed back to the customer, tacey-payment-owed when nothing is owed by the customer. A tag stays on while any other record on the same order still needs it.

Two small read-only checks run right after this job, in the same step. One confirms that an order Tacey cancelled after a merge, or a cancel a customer made, really shows as cancelled in Shopify. The other confirms that a payment capture you made went through. Neither one captures, refunds or cancels anything.

How to tell it ran

In Order changes, a refund you sent by hand in Shopify now reads as refunded, and the order no longer counts when you filter Money to Needs your action. In Shopify, the owed tag is gone.

What can stop it

  • Shopify's answer is unreadable. Nothing changes and the record stays open for the next run.
  • Tacey is in the middle of sending the refund itself. The record belongs to that send, and this job leaves it alone.
  • The refund you made is smaller than the amount owed, or in another currency. The record stays open. Refund the rest, or contact support.
  • The order is over 90 days old. Use the daily check or ask support.

Settling a merged order's shipping refund (combine_refund_settle)

What it does

When you press Refund on a merge's shipping panel in Merge History, Tacey asks Shopify to send the duplicate shipping back. Sometimes the answer never comes back (a timeout). Tacey cannot tell then whether the refund went through, and it must never send it twice.

This job settles that doubt without sending anything. It waits until the record has been untouched for about a minute and a half, so it never races a refund still being sent, and then looks at the refunds on the order for the one carrying this record's note.

What it findsWhat happens
The refund is there and it succeededThe panel moves to Shipping refunded, and the ledger is updated from Shopify's own refund
The refund is there and it failedThe panel shows The refund did not go through. Refund the shipping by hand in Shopify
No refund yet, and under 10 minutes have passedIt waits and looks again at the next run
No refund after 10 minutesThe send never landed. The record goes back to Shipping charge owed to the customer, with its Refund button, and shows again when you filter Money to Needs your action
It cannot read the orderNothing changes, and it tries again at the next run

The job has no way to send a refund. Only your own click on Refund can, and that click shows the exact amount first. See What happens to the money when Tacey combines two orders?.

When something looks stuck

The customer paid but the order is still on hold.

  1. Open the order in Shopify and check what it still owes. A partial payment, or a second unpaid change, keeps the balance above zero and the hold on.
  2. Check whether the hold is Tacey's. Its reason reads Awaiting payment. A hold with another name is not Tacey's, so release it in Shopify.
  3. Wait one more run. If Shopify was slow, the job asks again 15 minutes later.
  4. If a payment is shown paid in Shopify and the hold is still on after an hour, contact support with the order number.

The hold came off but the change says Payment was never completed. Shopify's balance reached zero without a payment on the order, for example because the price was lowered. No money moved. The label records that no payment arrived. See What do the money labels mean?.

I refunded by hand and Order changes still says refund owed. The job settles only a refund that is at least the owed amount, in the same currency, made after the change. A smaller refund leaves it open. Check the refund amount and currency in Shopify. If the amount is right, wait one run.

The tag tacey-refund-owed or tacey-payment-owed is still on the order. The tag comes off only when no record of that kind is left open on the order. Another open record keeps it on. Open the order's What changed on this order panel to see which one.

A merge's refund shows a button again after I pressed it. The send never landed, and the job returned it to you after 10 minutes. Press Refund again. Tacey asks Shopify for the exact amount again and will not send twice.

Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app.

Was this helpful?

One tap tells us whether this article did its job.

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