Zero Value (total amount) Order status change OPEN->PAID

Question

question

vadique asked Oct 6, '20 mikhail edited Dec 29, '22

Zero Value (total amount) Order status change OPEN->PAID

Hi there!

Use-case for e-comm API

- We have items that have $0.00 value that can be added to an e-comm order (gifts/comps/promos) which need to show up in reporting.

- We can create an e-comm order with such zero-amount items, and then use a valid payment "token" to "pay" for the order.

- If an order has ONLY zero-amount items, it will remain in "OPEN" state, even though Payment Type gets set to "Paid in Full" and it is not possible to "force" update state to "PAID" via API. The items from such orders (open state) do not show up in sales reports.

- However IF an order has an item that is non-zero amount AND items that are $0.00, then the order gets closed (PAID) and all items show up in sales reporting including $0.00 items

--update--

I verified that on POS (device) I can create a $0.00 item, add it to an order, and then pay (card/cash). The order is then set to Closed/Paid

I also verified that on POS (device) I can open a previously submitted ecomm order for $0.00, and addpayment/pay. The order is then set to Closed/Paid.

Please adivse:
- $0.00 eComm order should be Closed/Paid if a valid token used to pay for it via API - this would match the POS/Device behavior.

- Ability to set "PAID" status via API for $0.00 eComm order.

Order with zero-value item only. This order can not be "closed/paid" and item will not show up in reporting.

Order with zero-value item + another non-zero-value item. This order can be closed and ALL items will show up in reporting.

How can we close/finalize an order with $0 total?

Orders e-commerce api

ecom1.png (199.1 KiB)

ecom2.png (207.0 KiB)

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 · 2020-10-12T01:14:26Z

vadique answered Oct 12, '20 vadique commented Oct 12, '20

Seriously, 5 days no answer?

2

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.

David Marginian ♦♦ commented · Oct 12, 2020 at 02:06 AM

I will write up a issue for ecomm. What API are you using to create the order?

0 ·

vadique David Marginian ♦♦ commented · Oct 12, 2020 at 02:08 PM

See answer #2 above

0 ·

Answer 2 · 2020-10-12T04:24:02Z

vadique answered Oct 12, '20 David Marginian Deactivated commented Oct 21, '20

David:

Here's the flow for all orders using EComm API:
- User selects items enters the card and clicks "pay"

- Obtain payment token via iFrame eComm implementation ( a user always enters a valid card even for $0.00 order, so we always get a payment token)

const clover = new Clover({merchant_mapi_key});clover.createToken()....

- Create Order (may contain ONLY $0.00 items, OR a mix of $0.00 and >$0.00 items)
POST: scl.clover.com/v1/orders (or sandbox endpoint)

{
    "currency": "usd",
    "email": "***",
    "name": "asd asdf",
    "items": [
      {
        "quantity": 1,
        "amount": 0,
        "description": "test comp zero val item"
      }
    ]
}

>> Order created success {ORDER-ID}
>> (This is always successful regardless of $0.00 or non $0.00 items)
>> Response:

{
  id: 'S2D8KKSD38222',
  object: 'order',
  currency: 'usd',
  created: 1602475777000,
  email: '****',
  items: [
    {
      type: 'sku',
      quantity: 1,
      description: 'test comp zero val item'
    },
    { type: 'tax', description: 'Taxes (included)' }
  ],
  status: 'created'
}

- Pay for order with the token (source)
POST: scl.clover.com/v1/orders/{ORDER-ID}/pay (or sandbox endpoint)

>> This is always successful returned as PAID
Response:

    {
  id: 'S2D8KKSD38222',
  object: 'order',
  currency: 'USD',
  charge: 'HWA4THTD05CMP',
  created: 1602475777000,
  ref_num: '1750003256',
  items: [ { quantity: 1, description: 'test comp zero val item' } ],
  source: {
    address_zip: '12312',
    brand: 'VISA',
    exp_month: '02',
    exp_year: '2022',
    first6: '424242',
    last4: '4242'
  },
  status: 'paid',
  status_transitions: { paid: 1602475777758 }
}

The expectation is that the PAID eComm order should be always CLOSED to match the POS behavior. If the order contains at least one non-zero value item - the behavior seems to be correct (order closed).

However, if the order contains only $0.00 item(s) - it remains OPEN. It can not be closed via api.clover.com/orders status update, but It can be closed from device->orders->addPayment manually.

5

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.

David Marginian ♦♦ commented · Oct 12, 2020 at 02:14 PM

Thanks, I created an issue for the ecomm team.

0 ·

vadique David Marginian ♦♦ commented · Oct 19, 2020 at 08:00 PM

Hi David. Any update on this?

0 ·

David Marginian ♦♦ vadique commented · Oct 19, 2020 at 08:07 PM

No, I have created the issue and will be notified of any changes. Unfortunately, I don't anticipate this being resolved soon.

0 ·

Show more comments

Answer 3 · 2022-12-29T06:39:16Z

mikhail answered Dec 29, '22 mikhail edited Dec 29, '22

hi. Are there any updates on the issue since 2020? Is it possible to create closed/paid zero-total orders?

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.

question