Reverse (Void)

A reverse voids a transaction before settlement, releasing the hold on the cardholder's funds immediately. Use it to cancel a sale or preauth that hasn't settled yet.

For returning funds after settlement, see Refund.

Full Reverse

iOS:

let response = try await KoardMerchantSDK.shared.reverse(
    transactionId: transactionId,
    eventId: UUID().uuidString
)

Android:

sdk.reverse(
    transactionId = transactionId,
    eventId = UUID.randomUUID().toString()
)

Partial Reverse

Reduce the authorized amount without voiding the entire transaction:

iOS:

let response = try await KoardMerchantSDK.shared.reverse(
    transactionId: transactionId,
    amount: 5000,             // reduce hold by $50
    eventId: UUID().uuidString
)

Android:

sdk.reverse(
    transactionId = transactionId,
    amount = 5000,
    eventId = UUID.randomUUID().toString()
)

Surcharge Handling

When reversing a surcharged transaction, the full surcharge is released automatically. No breakdown is needed—the processor handles the surcharge reversal.

When to Use Reverse vs. Refund

Parameters

See Also

• Refund — Return funds after settlement
• Sale — Original payment
• Preauth — Authorization hold