Many users expect to refund a credit note back to the customer's card directly from Zoho Books or Zoho Commerce. Zoho Books does not automatically push a credit-note refund to the payment gateway in all cases, so you usually must refund on the gateway and then record that refund in Books/Commerce[1][7].
What it means — concrete explanation tied to the Zoho API surface
Zoho Books records invoices, credit notes, payments, and bank/account transactions, and Zoho Commerce creates orders that can post payments into Books. However, creating a credit note in Books does not always call the payment gateway API to issue a card refund. That gap means the card provider may not get a refund instruction until you issue it from the payment gateway (Stripe, PayPal, etc.) and then record the returned funds in Books/Commerce. The product and community notes confirm this workflow expectation and related feature requests[1][7][2].
Common causes
- The credit note was created in Books but no refund action was executed on the payment gateway, so the card was never refunded[1][7].
- The order payment came through Zoho Commerce but the Commerce-to-Books sync did not map the payment/refund action to the gateway refund API[6][1].
- The original payment has settled and the refund window or gateway rules require you to refund from the gateway dashboard rather than via Books API[1].
- Your Sales Return or RMA workflow is not set to the "Accepted" status or your account lacks the Sales Returns feature needed to push returns through existing approval workflows[2].
How to fix it
- Confirm the original payment method and settlement status in Zoho Commerce > Orders > select order > Payments, or in Zoho Books > Sales > Payments received. Note the gateway (Stripe, PayPal, Razorpay, etc.) and the payment ID[6][1].
- Issue the refund from the payment gateway dashboard or API using the original payment ID (Stripe dashboard Refunds, PayPal Refund transaction). Do not rely on the credit note alone to refund the card unless your gateway integration explicitly supports it. Record the refund reference from the gateway.
- In Zoho Books, create a corresponding refund transaction: record a bank/undeposited account deposit or use Payments > Record Refund (or create a credit note and apply the payment refund) so Books shows the refunded amount and matches bank statements. Include the gateway reference in the description for reconciliation[1].
- If the order was in Zoho Commerce, ensure the Commerce payment/refund sync is enabled and that the refund is recorded against the same order. If the integration did not automatically sync, manually update the order status and add a note with the gateway refund ID[6].
- If you use Sales Returns/RMA workflows, set the return to Accepted so any configured approvals or push-to-ledger behavior executes; then follow steps 1–4 to complete the financial refund flow[2].
- Reconcile the refund in Books against your bank feed or statement and attach the gateway refund receipt to the transaction for audit trail.
When to escalate
If you cannot locate the original payment ID, if the payment gateway shows no record of a refund attempt, or if Commerce and Books fail to sync refund records after you issued them at the gateway, open a support ticket with Zoho (include order ID, payment ID, gateway refund ID, and screenshots). Zoho support can check sync logs and backend mappings for your organization[1][6].