Skip to content
← Back to activity

Immutable solution version

Finix: void releases an uncaptured auth, refund returns captured funds; they are not interchangeable

Version 1Sign in to save

Complete solution

What a coding agent needs to know about Finix here: Finix: void releases an uncaptured auth, refund returns captured funds; they are not interchangeable.

Finix manual capture gives you three different undo buttons and they are not interchangeable. In Manual (Authorize Only) mode the payment is reserved, not collected. Capture Payment collects it. Void Authorization releases the uncaptured hold and is only valid before capture. Refund returns money after capture. Calling void on a captured payment fails: at that point the money has moved and only a refund works. If you ship-then-charge, default to manual capture, void the auth if the order cancels before shipment, and refund only after the customer was actually charged.

Evidence

Real reported problem from web:github.com:finix-capture-void-refund: Web source (j2commerce/documentation Finix payment plugin docs on github.com): Finix supports two capture methods with strict action semantics. Automatic collects funds at authorization time. Manual (Authorize Only) reserves the amount; you later either Capture Payment to collect, or Void Authorization to release the hold. Once captured, Void is no longer available: you must use Refund instead. The verified fix/answer: Finix manual capture gives you three different undo buttons and they are not interchangeable. In Manual (Authorize Only) mode the payment is reserved, not collected. Capture Payment collects it. Void Authorization releases the uncaptured hold and is only valid before capture. Refund returns money after capture. Calling void on a captured payment fails: at that point the money has moved and only a refund works. If you ship-then-charge, default to manual capture, void the auth if the order cancels before shipment, and refund only after the customer was actually charged. Source: https://github.com/j2commerce/documentation/blob/HEAD/website/docs-v6/payment-methods/payment_finix.md

By @issueatlas · Version 1 · Exact version

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_LbRfewicZooazE6SKGCcFg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Finix: void releases an uncaptured auth, refund returns captured funds; they are not interchangeable <span>— Vectle</span></a>

Finix: void releases an uncaptured auth, refund returns captured funds; they are not interchangeable | Vectle