thread Re: [Connect v2 Api] - Is it possible to add Tips in a transaction request in Payments Troubleshooting

[Connect v2 Api] - Is it possible to add Tips in a transaction request

Thiago — Sun, 21 Sep 2025 17:44:39 GMT

Hi,

I would like to use the Transaction (charge) endpoint to make a payment, within that, I need to add tips percentage/value too.

I was checking the documentation, but I couldn't find a way to add it in the request.

There's tip_money in Tender object, but I couldn't check how to associate a tender to a transaction (or order), because I am going to use the card_nonce or customer_card_id/customer_id.

I've seen the v1 Payment object that has a tip_money too. But I couldn't find how to create a payment using v1 (only list and retrieve).

So I was wondering how I can manage to do it, and if this is the correct way.

Thank you.

Re: [Connect v2 Api] - Is it possible to add Tips in a transaction request

Helen — Mon, 28 May 2018 18:16:45 GMT

Hi @Thiago and welcome to the Seller Community. I checked with our API Specialists for you and they confirmed that there isn't a percentage value feature with a transaction. If this feature is available in future we'll update this thread to let you know.

Re: [Connect v2 Api] - Is it possible to add Tips in a transaction request

Thiago — Mon, 28 May 2018 20:54:30 GMT

Thank you Helen!

Is there any workaround that could be done to associate the value of the tips? I was thinking about increment the amount_money in the transaction but inform in the (maybe) notes field. But not sure if that's the right/clever way to inform the percentage/amount of tips that have been paid.

Or is there any other way to do the payments? The feature Checkout doesn't work well for us because we need fully customized views.

Thank you again for the quick response!

Re: [Connect v2 Api] - Is it possible to add Tips in a transaction request

Thiago — Tue, 29 May 2018 21:34:04 GMT

Hi @Helen!

Just following up here, any news?

Thank you.

Re: [Connect v2 Api] - Is it possible to add Tips in a transaction request

Helen — Tue, 29 May 2018 22:23:42 GMT

Sorry to keep you waiting! Our API team took another look for you.

It is possible to use the notes field as a work around but not recommended. If you are calculating the additional amount_money tip that will be added to the total amount charged in a transaction you could use the Square's Catalog API.

With the Catalog API you have the ability to create a variable item with the CatalogPricingType. This Enum indicates whether the price of a CatalogItemVariation should be entered manually at the time of sale.

If you create an item with the CatalogPricingType set to VARIABLE_PRICING this will allow you to enter the increment custom amount that you calculated as a tip.

As a quick reminder, it's best for developers who are looking to create/manage items and variations in a programmatic way.