Ecommerce API: How to correctly refund tax?

Question

question

kirank asked Nov 8, '21 kirank commented Nov 10, '21

Ecommerce API: How to correctly refund tax?

We are creating an order with v3/orders and refunding with v1/orders/{orderId}/returns . All on E-Commerce api/REST api

The order has taxes & service charge applied. The issue is while we can refund items to finally set the order to $0, the "Reporting - Sales Overview" shows negative "Net Sales" (Equal to tax+service charge). My guess is if we are able to correctly refund tax and service charge as their own types (during refund we are artificially increasing amount of the line item). The flow we have is pretty lengthy and I think we are doing this incorrectly. What is the correct way to refund the whole order and refund line items?

Orders e-commerce api Refund

10 |2000

Attachments: Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Welcome to the
Clover Developer Community

Answer 1 · 2021-11-08T12:28:22Z

David Marginian Deactivated answered Nov 8, '21 kirank commented Nov 10, '21

You are passing the item into the returns endpoint, have you tried not passing anything? See: https://docs.clover.com/docs/ecommerce-refunding-payments#refunding-payments-without-order-items-to-be-returned.

3

10 |2000

Attachments: Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

kirank commented · Nov 10, 2021 at 09:32 AM

As you suggested, when the order is completely paid, full order return with no line Items correctly refunds taxes and charges.

What is missing (atleast in our understanding) is:

1. If the order is partially paid, how to refund the tax?

v1/orders/{id}/returns API does not have a way to refund taxes & service charge fee.
When taking payment for partial payment, we are able to clearly specify the tax, but not for refund

2. If order is fully paid or partially paid, refunding a single charge using /v1/refunds does not track the tax amount refunded. This leaves the order state with tax still collected.

The only way we see taxes and charges can be refunded & have a balanced sales reports is via fully paid orders with full refunds.

Partially paid orders can't be refunded (to our knowledge). Partially paid orders is common in some online order verticals.

0 ·

David Marginian ♦♦ kirank commented · Nov 10, 2021 at 12:44 PM

Yes, unfortunately we don't have full support for partial refunds right now. We have an open issue for it and hopefully we can address it early next year.

0 ·

kirank commented · Nov 10, 2021 at 05:00 PM

Thanks, this clarifies the understanding. For now we'll take away this: Fully paid orders can be refunded. Partially paid orders can't be refunded on REST API.

0 ·

question