Cancelar un cobro en curso
stopTransaction aborta un cobro que aún no se autorizó, mientras el SDK espera que el cliente acerque la tarjeta.
:::danger Nunca canceles durante la lectura de la tarjeta
No llames stopTransaction mientras el SDK está leyendo la tarjeta — es decir, desde que dispara onReadingCardData(). Interrumpir el diálogo con el chip deja la transacción en un estado indeterminado: el lector puede haber avanzado sin que tu app lo sepa. Espera al desenlace y, si hace falta deshacer el cobro, usa la reversión.
:::
La ventana segura para cancelar es entre onPresentCardRequest() y onReadingCardData(). Después de la lectura, si el modo es USER_CONFIRMATION, el camino para no cobrar es responder transactionConfirmation(sendTransactionAuthorization = false), no stopTransaction.
:::caution Solo disponible en MIGO_PAY
stopTransaction solo está implementado en MIGO_PAY. En las integraciones MIGO_LINK_* la llamada no hace nada y ningún callback se dispara: el cobro sigue su curso en el lector. Ahí el cliente cancela desde el flujo del propio lector.
:::
:::info Esto no es una reversión Para deshacer un cobro que ya fue autorizado, el método es otro y el flujo también. Ver Reversar un cobro autorizado. :::
Abortar
import com.migo.sdkmigo.domain.usecasesparams.StopTransactionParams
migoSDK.stopTransaction(StopTransactionParams(mActivity = this))
El SDK responde con onTransactionCancelled() y siempre con onGeneralException(STATE_TRANSACTION_CANCELLED_BY_USER, …). Ese segundo callback es la confirmación de la cancelación, no un fallo — trátalo aparte del resto de excepciones:
override fun onGeneralException(exception: GeneralMigoException?, message: String?) {
when (exception) {
GeneralMigoException.STATE_TRANSACTION_CANCELLED_BY_USER -> {
// Cancelación esperada, no es un error
}
else -> showError("Error: $message")
}
}
Una vez abortado, el cobro no puede reanudarse: inicia uno nuevo si aún necesitas cobrar.
Cuándo ya no puedes abortar
stopTransaction deja de aplicar en cuanto el procesador autoriza. A partir de onVoucherDataResponse con isTransactionApproved = true, el dinero ya se movió y el camino es la reversión.
doTransaction()
│
├─ onPresentCardRequest ✅ stopTransaction seguro
├─ onReadingCardData ⛔ NUNCA cancelar
├─ onReturnCurrentTransactionInfo
│ ↳ para no cobrar: transactionConfirmation(false)
└─ autorizado ↳ para deshacer: reversión
Relacionado
- Reversar un cobro autorizado — deshacer un cobro ya aprobado.
- Procesar un pago con terminal — el cobro paso a paso.