Resolve "9953 Secondary amounts cannot exceed the total amount" Error on Universal Transaction Gateway

What is causing this Error?

In the POS request to the UTG, they are sending a payload containing the various elements in the “amount” key’s object (such as “tip,” "tax,” etc.) that exceed the “total” value in the “amount” key’s object. 

For example:

“Amount”:{ “total”:10, “tip”:20, “tax”:20 } - This would fail because (tip+tax)>total

“Amount”:{ “total”:10, “tip”:2, “tax”:2 } - This would succeed as (tip+tax)<total

How do I resolve this Error?

This error indicates that the POS is sending an improperly formatted REST request. The POS should always manually calculate the total amount to charge the card, and the other “tip,” “tax,” etc. values are purely information. This is not something that the merchant or even POS support will be able to fix permanently. The POS developers must code the interface better to ensure this does not happen. 

More information is available in the REST API documentation.