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 isadjust().
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 |
