Parámetros de respuesta

Esta página de referencia enumera todos los parámetros de salida (extras del intent) devueltos por la app Tap on Phone.

Al iniciar un intent utilizando la API Activity Result de Android, la app Tap on Phone devuelve un código de resultado (RESULT_OK o RESULT_CANCELED) junto con un objeto Intent que contiene estos campos de datos.

Parámetros de éxito (RESULT_OK)

Cuando una operación finaliza sin un error fatal del sistema o cancelación por parte del usuario, la app Tap on Phone devuelve Activity.RESULT_OK. Extrae los siguientes parámetros de los datos del intent devuelto para registrar la transacción y generar recibos.

RESULT_OK indica que la app Tap on Phone procesó la solicitud con éxito. Esto no significa que se haya aprobado una transacción financiera. Comprueba siempre el parámetro status para determinar el resultado financiero real.

Estado de la transacción

Nombre del Parámetro	Tipo de Dato	Descripción
`status`	String	El estado final definitivo de la transacción financiera. Los valores son `APPROVED` o `DECLINED`.
`authorized`	Boolean	Un booleano de conveniencia derivado del campo `status`. Devuelve `true` si se aprueba, `false` si se deniega.
`detailedStatus`	String	El estado interno detallado de la transacción. Nota: No utilices esto para comprobar el estado final de aprobación, ya que puede reflejar un estado temporal.
`declineError`	String	El código de error del sistema si se deniega la transacción.
`declineCause`	String	La descripción legible por humanos del motivo de la denegación.

Identificadores

Nombre del Parámetro	Tipo de Dato	Descripción
`id`	Int	El ID de la base de datos (DJM).
`transactionId`	Int	El ID interno de Tap on Phone para la transacción. Debes guardarlo si tienes la intención de realizar un reembolso, cancelación o finalización de preautorización más adelante.
`userId`	Int	El identificador técnico de usuario asignado a la sesión actual.
`merchantId`	Int	El identificador único de comercio de Tap to Pay.
`terminalId`	String	El ID del Wallet/Terminal del dispositivo móvil.
`uuid`	String	ID único del recibo, utilizado para obtener sus datos del backend de Tap on Phone.

Datos financieros

Nombre del Parámetro	Tipo de Dato	Descripción
`amount`	Long	El importe total de la transacción en céntimos (p. ej., `1200` para $12.00).
`tip`	Long	El importe de la propina en céntimos.
`currency`	String	El AlphaCode de la moneda ISO 4217 (p. ej., `EUR`, `USD`).
`date`	String	La fecha y hora de la transacción.

Detalles de tarjeta y EMV

Nombre del Parámetro	Tipo de Dato	Descripción
`scheme`	String	La red de pago utilizada. Los valores posibles incluyen: `Visa`, `Mastercard`, `Amex`, `CB`, `Discover`, `DinnersClub`, `Elo`, `Conecs`, `Pago`, `Bankaxept`.
`mode`	String	El modo de pago. Los valores son `Contactless` y `Link`.
`pan`	String	El Primary Account Number (PAN) enmascarado (p. ej., `************1234`).
`aid`	String	El AID (Identificador de Aplicación) EMV seleccionado.
`applicationLabel`	String	La etiqueta legible por humanos de la aplicación EMV seleccionada.
`authMode`	String	El modo de autorización EMV.
`authCode`	String	El código de autorización EMV generado por el emisor.
`transactionType`	String	El valor del Tipo de Transacción EMV (Etiqueta 9C). (`00` para Compra/Preautorización, `20` para Reembolso, `22` para Cancelación).
`completionMode`	String	Indica el modo de finalización de la transacción. Los valores son `AUTO`, `PREAUTH` o `PENDING`.

Datos del recibo

Nombre del Parámetro	Tipo de Dato	Descripción
`formatedString`	String	Una cadena de texto plano preformateada que contiene el diseño completo del recibo, lista para su impresión o visualización.
`receiptUrl`	String	Una URL única que aloja el recibo digital para el cliente.
`cancellationExpiryDate`	String	La fecha y hora máximas antes de las cuales puedes cancelar el recibo. Después de esta fecha, debes procesar un reembolso en su lugar.

Parámetros obsoletos

Nombre del Parámetro	Tipo de Dato	Descripción
`latitude`	String	Siempre devuelve `null`. Programado para su eliminación en futuras versiones.
`longitude`	String	Siempre devuelve `null`. Programado para su eliminación en futuras versiones.

Parámetros de error (RESULT_CANCELED)

Si el usuario aborta manualmente la transacción (por ejemplo, pulsando el botón de retroceso) o si el sistema encuentra un error que impide que la transacción se complete, la app Tap on Phone devuelve Activity.RESULT_CANCELED.

Si un error causó la cancelación, los datos del intent contienen los siguientes campos. Si el intent no contiene estos campos, indica una cancelación manual por parte del usuario.

Nombre del Parámetro	Tipo de Dato	Descripción
`errorCode`	String	El código de error específico de 6 dígitos que detalla el fallo (p. ej., 10-2110). Consulta la página de Result Codes and Errors para obtener una lista completa.
`errorName`	String	El nombre técnico del error (p. ej., `BackendTimeout`).
`errorMessage`	String	Un mensaje descriptivo que explica el error.