Create charge endpoint calculation

Question

question

01928-7325x2 asked Apr 14, '23 bryanvargas commented May 15, '23

Create charge endpoint calculation

I'm using create charge endpoint(https://scl-sandbox.dev.clover.com/v1/charges).
However the payment receipt is showing different amount than the total amount I sent.

Sample payload

{
  amount: 4400,
  tipAmount: 660,
  taxAmount: 440,
  source: 'clv_XXSTS1LXnXevtX44n9dmXXXX',
  currency: 'usd',
  receiptEmail: 'user@email.com'
}

Receipt

Payment data displayed in the Clover order page

What could be the problem?
Here is the payment receipt link: https://sandbox.dev.clover.com/p/ZFK003SWYEM34

Payments ecommerce

screenshot-2023-04-14-at-111314-pm.png (103.0 KiB)

screenshot-2023-04-14-at-111404-pm.png (86.8 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 · 2023-04-14T16:21:13Z

bryanvargas answered Apr 14, '23 01928-7325x2 commented Apr 15, '23

If the charge request includes tax (tax_rate_uuid or tax_amount), this value must be the sum of all item prices and any tax or tip. Example: If the item costs $10 and the tax is $1, the amount is 1100 ($11).
Here is my example:

{  
"amount": 2000,
 "tip_amount": 350,
    "tax_amount": 200
     "capture": true,
     "currency": "USD",
     "description": "test",
     "ecomind": "ecom",
     "receipt_email": "{email}",
     "source": "cToken"
}

screenshot-2023-04-14-at-122042-pm.png (35.5 KiB)

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.

01928-7325x2 commented · Apr 14, 2023 at 06:00 PM

In your example receipt
subtotal 1800
tax 200
tip 350

But in your payload the amount is 2000 which missing the tip amount. I thought the amount should includes everything?
How could your payload displayed correctly in the payment receipt?

0 ·

01928-7325x2 01928-7325x2 commented · Apr 15, 2023 at 07:53 PM

@bryan.vargas I'm not sure how this marked as accepted answer. There is still unanswered question here.

Thanks!

0 ·

Answer 2 · 2023-04-14T16:55:31Z

01928-7325x2 answered Apr 14, '23 01928-7325x2 edited Apr 15, '23

Sorry, I still don't understand from the last reply.
Maybe the example below is better
In the payment detail it shows the correct payment amount and tip amount.
My payload has tax_amount, so the total payment amount is subtotal + tip amount which is correct $32.40.

Payment receipt showing subtotal + tip

screenshot-2023-04-14-at-113431-pm.png (92.1 KiB)

screenshot-2023-04-14-at-113439-pm.png (105.5 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.

Answer 3 · 2023-04-14T17:05:14Z

01928-7325x2 answered Apr 14, '23 bryanvargas commented May 15, '23

Here is the same order but the 'tip_amount' is not included in the 'amount'

The payment receipt is correct.

Maybe I misunderstood what "Payment amount" means in the order page? But per documentation, the tip must be included in the payload's "amount" prop.

screenshot-2023-04-15-at-10237-am.png (86.9 KiB)

screenshot-2023-04-15-at-10325-am.png (131.2 KiB)

1

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.

bryanvargas ♦♦ commented · May 15, 2023 at 02:05 PM

The answer I provided is still valid. Your other examples did not include the taxes so the subtotal will the total you presented and the total will be the included tips. , please review : https://docs.clover.com/docs/calculating-order-totals

0 ·

question