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

[Thiago]

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.

[Helen]

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.

[Thiago]

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!

[Thiago]

Hi @Helen!

Just following up here, any news?

Thank you.

[Helen · Accepted solution]

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.