Tip Adjust

Tip adjust updates the tip amount on a transaction that has already been authorized but not yet settled. Use it when the customer adds or changes a tip after the initial payment.

Basic Tip Adjust

iOS:

let response = try await KoardMerchantSDK.shared.tipAdjust(
    transactionId: transactionId,
    tipAmount: 3000            // $30.00 tip
)

Android:

sdk.adjust(
    transactionId = transactionId,
    tipAmount = 3000
)

Note: The iOS SDK method is tipAdjust() while the Android SDK method is adjust().

Surcharge Behavior

When a tip is adjusted on a surcharged transaction, the surcharge is not recalculated. The original surcharge amount remains unchanged. If you need to recalculate the surcharge based on the new total (subtotal + tax + new tip), you should handle that in your capture flow instead.

Parameters

Parameter Type Required Description
transactionId String Yes Transaction to adjust
tipAmount Int Yes New tip amount in minor units

See Also

  • Sale — One-step payment
  • Preauth — Hold with tip added later
  • Capture — Finalize with updated tip