ECommerce Partial Refund

Question

question

kirank asked Sep 7, '21 David Marginian Deactivated commented Sep 8, '21

ECommerce Partial Refund

Hi,

I have an ecommerce Charge of say $138.94 and tax_amount was set at $0.14. So when charge was sucessful, Order detail line (merchants/mid/v3/orders/) items show as $138.88. But no line item information about the $0.14 tax.

The eCommerce Order (scl-sandbox.dev.clover.com/v1/orders/ ) shows like this:

"amount": 13894,
"items": [
    {
      "quantity": 1,
      "amount": 13880,
      "description": "Item 1"
    },
    {
      "type": "tax",
      "description": "Taxes (included)"
    }
  ]

In the above line item for tax is missing the "amount" field. It does not show up anywhere else.

What we are actually trying to do is refund all of $138.94 via ecommerce refund order endpoint. We are getting a Error 500 (it needs to be more informative than 500).

----- debug ecomReturnOrder to post
{
  items: [
    {
      amount: 13894,
      description: 'Refund amount PR0077000960',
      quantity: 1
    }
  ]
}

My main question is how do I refund the tax of $0.14? The Error 500 has a workaround mentioned in the community elsewhere.

Sandbox Order ID: F4MQZZHAWKGS4

Sandbox Charge: FF6HVFQ31KGTE

e-commerce api Taxes

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-09-07T11:54:23Z

David Marginian Deactivated answered Sep 7, '21 David Marginian Deactivated commented Sep 8, '21

I am a bit confused, the subject line says "ECommerce partial refund" but you seem to be asking about refunding the full charge amount. If you are trying to return the full charge amount why are you not using the returns endpoint? https://docs.clover.com/docs/ecommerce-refunding-payments#refunding-payments-without-order-items-to-be-returned

6

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 · Sep 07, 2021 at 03:26 PM

We want to refund the tax portion (for various customer specific various reasons). So either we refund from the main item by lowering the item amount or the tax line item itself. We don't want to do a full return.

0 ·

David Marginian ♦♦ kirank commented · Sep 07, 2021 at 03:29 PM

You want to refund the tax only? Tax is not a line item.

0 ·

kirank David Marginian ♦♦ commented · Sep 07, 2021 at 03:52 PM

Our higher end goal is this: Some excess tax was captured due to incorrect rate applied (at the time charge was created, we provided tax_amount). The item was not taxable but they incorrectly setup the item to capture tax. The merchant wants to now correct it by returning the tax.

Other scenarios are like this:

1. Customer purchased something with tax.

2. They exchanged for an item that is non-taxable for same value. Tax is now still remaining on Clover. We need to refund that tax.

0 ·

Show more comments

question