{"templateId":"../../../@theme/Templates/ReleaseNote.tsx","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown","date":"2026-10-19","monthLabel":"October 2026","order":0},"seo":{"title":"Pending Refunds","description":"Refunds now enter a PENDING state while Finix confirms your settlement balance can cover them, then submit automatically once funded.","siteUrl":"https://docs.finix.com","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Low-Code / No-Code","includeFiles":["low-code-no-code/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]},{"title":"Release Notes","includeFiles":["release-notes/**/*.md"],"excludeFiles":[]}]},"image":"/assets/additional-resources-release-notes.9735f92c59d5741ad884fb4d9a1496310d990a863871921fa63028cdf2aed328.04fe652d.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pending-refunds","__idx":0},"children":["Pending Refunds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We've updated how refunds are submitted so that there are sufficient funds in your settlement to cover them. For merchants with a pending-refunds strategy enabled, Finix now holds refunds in a temporary ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," state while it verifies that the settlement balance can cover the amount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Previously, refunds for these merchants were submitted immediately. If a settlement did not have enough sales to cover a refund, you were debited for the difference."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-pending-refunds-work","__idx":1},"children":["How pending refunds work"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Daily settlement checks:"]}," Before your daily settlement is approved, Finix checks pending refunds in the order they were created. If your settlement balance covers a refund, Finix submits it and updates it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCCEEDED"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bank debit after 7 days:"]}," If your daily sales do not cover a pending refund after 7 calendar days, Finix automatically debits the linked bank account for the amount. Once the debit clears, typically within 3 business days, Finix submits the refund."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expiration after 45 days:"]}," A refund can stay in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," for up to 45 days. If it cannot be funded by the settlement balance or a bank debit in that time, the refund moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}," with the failure code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REFUND_EXPIRED"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/pending-refund-states.8215ec51743cc7c4b5d8ef091533c38538649a070c08f8d1d7e3aba4f3acae11.28b10c14.png","alt":"Flowchart of a pending refund from creation through daily settlement checks, bank account debit, and success or expiration","framed":false,"withLightbox":false,"style":"width: 80%"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-need-to-do","__idx":2},"children":["What you need to do"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review your API integration and webhooks:"]}," Refunds can now return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state: PENDING"]},". Update any logic that expects a refund to succeed or fail immediately."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test in Sandbox:"]}," You can test the full pending refund flow in your Sandbox environment."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have questions, reach out to your Customer Delivery Manager or email ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/after-the-payment/refunds/pending-refunds"},"children":["Pending refunds guide"]},"."]}]},"headings":[{"value":"Pending Refunds","id":"pending-refunds","depth":1},{"value":"How pending refunds work","id":"how-pending-refunds-work","depth":2},{"value":"What you need to do","id":"what-you-need-to-do","depth":2}],"frontmatter":{"template":"../../../@theme/Templates/ReleaseNote.tsx","seo":{"title":"Pending Refunds","description":"Refunds now enter a PENDING state while Finix confirms your settlement balance can cover them, then submit automatically once funded.","image":"/assets/additional-resources-release-notes.9735f92c59d5741ad884fb4d9a1496310d990a863871921fa63028cdf2aed328.04fe652d.png"},"metadata":{"date":"2026-10-19","monthLabel":"October 2026","order":0}},"lastModified":"2026-11-20T15:25:04.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/release-notes/2026/10/pending-refunds","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}