Referencia de parámetros del deeplink

Esta página reúne un catálogo consolidado de todos los URI de deeplink de App2App y sus parámetros de solicitud y respuesta. La comunicación con la Getnet Payment App se hace mediante Android Intents con URI específicos. Todos los parámetros se pasan como Extras en el Intent.

Deeplinks disponibles

La Getnet Payment App expone los siguientes deeplinks:

URI	Función
`getnet://payment/v1/payment`	Inicia una transacción de venta.
`getnet://payment/v1/commerce-data`	Devuelve los datos de registro del comercio.
`getnet://payment/v1/refund`	Inicia una devolución.
`getnet://payment/v1/polling`	Verifica si la Payment App puede atender deeplinks.
`getnet://payment/v1/get-info`	Devuelve información del terminal.
`getnet://payment/v1/last-transaction`	Devuelve o reimprime el último recibo.
`getnet://payment/v1/reports`	Devuelve reportes.
`getnet://payment/v1/cancel-operation`	Cancela una operación de deeplink en curso.
`getnet://payment/v1/shift`	Administra los turnos.
`getnet://payment/v1/pre-auth`	Inicia una preautorización.
`getnet://payment/v1/transaction-check-status`	Busca el estado de una transacción anterior específica.

getnet://payment/v1/last-transaction es el URI de producción para reimprimir o devolver el último recibo. getnet://payment/v1/reprint no es un deeplink de App2App en el esquema payment — no lo uses. Los ejemplos que lo muestran probablemente vienen del esquema de BR getnet://pagamento/v1/reprint, que es un contexto diferente.

Pago

URI: getnet://payment/v1/payment

Inicia una nueva transacción de pago. El parámetro paymentMethod selecciona tarjeta o QR Code.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`amount`	String	Sí	Total de la transacción en centavos, con dos decimales implícitos. Entero de hasta 9 dígitos; los ceros a la izquierda se aceptan, pero no son obligatorios (por ejemplo, `"1234"` = $12.34; `"10000"` = $100.00).
`originalAmount`	String	No	Valor en moneda local para realizar la transacción.
`receiptCode`	String	Sí	ID impreso en el recibo para el seguimiento del comercio.
`callerId`	String	No	Identificador único para correlacionar la solicitud con la respuesta.
`tip`	String	No	Monto de propina que se suma al total de la transacción. Mismo formato decimal que `amount`.
`waiterCode`	String	Condicional	Código del camarero para atribuir la propina. Obligatorio si se envía una propina.
`paymentMethod`	String	No	`"1"`: tarjeta, `"2"`: QR Code. Si lo omites, el terminal muestra la pantalla de selección.
`installments`	Integer	No	Cantidad de cuotas (solo tarjeta de crédito).
`planId`	String	No	ID del plan de cuotas. Consulta Reglas de cuotas.
`interest`	Boolean	No	Indica si el plan incluye intereses (`true`) o es sin intereses (`false`).
`operationMode`	String	No	`"0"`: manual, `"1"`: calculado. Consulta Estrategia de cálculo de intereses.
`skipReceipt`	Boolean	No	`"true"` omite la pantalla del recibo del cliente. Predeterminado `"false"`.
`skipConfirmation`	Boolean	No	`"true"` omite la pantalla de confirmación de importe y cuotas. Predeterminado `"false"`.
`allowPrintCurrentTransaction`	String	No	`"false"` devuelve los datos del recibo como `automationSlip`. Consulta Responsabilidad de impresión.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Resultado de la transacción. Consulta Códigos de resultado.
`resultDetails`	String	Mensaje detallado del resultado de la transacción.
`amount`	String	Monto de la transacción en moneda local.
`originalAmount`	String	Valor en moneda local para realizar la transacción.
`tip`	String	Monto de propina de la venta.
`waiterCode`	String	Código del camarero para atribuir la propina.
`receiptCode`	String	Identificación impresa en el recibo.
`callerId`	String	Se corresponde con la solicitud del deeplink.
`nsu`	String	Código de autorización de la transacción de Getnet, único por terminal y por día.
`nsuLastSuccesfullMessage`	String	Último NSU de Getnet generado con éxito.
`paymentType`	String	Tipo de pago (crédito, débito, voucher, etc.).
`brand`	String	Marca de tarjeta.
`inputType`	String	`021`: banda magnética, `051`: chip, `071`: chip contactless, `801`: fallback de banda magnética.
`installments`	String	Cantidad de cuotas.
`planId`	String	Plan de cuotas seleccionado.
`interest`	String	Indica si se seleccionaron intereses (`true`/`false`).
`gmtDateTime`	String	Fecha y hora GMT (MMDDhhmmss, UTC 0).
`authorizationCode`	String	Código de autorización de la transacción.
`cardBin`	String	Primeros 8 dígitos de la tarjeta.
`cardLastDigits`	String	Últimos 4 dígitos de la tarjeta.
`sellerCode`	String	Código de sucursal aprobado por Getnet.
`terminalCode`	String	Código del terminal POS.
`paymentMethod`	String	`"1"`: tarjeta, `"2"`: QR Code.
`automationSlip`	String	Datos del recibo en formato JSON. Consulta Responsabilidad de impresión.

Devolución

URI: getnet://payment/v1/refund

Revierte una transacción aprobada previamente. Se admiten devoluciones parciales cuando el importe es menor que el original.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`authorizationCode`	String	Sí	Código de la transacción original que aparece como “AUT” en el recibo.
`transactionDate`	String	Sí	Fecha de la transacción original en formato `dd/MM/yyyy`.
`amount`	String	Sí	Valor que se va a revertir. Si es menor que el original, se realiza una devolución parcial.
`refundType`	String	No	`"1"`: venta con retiro, `"2"`: venta, `"3"`: retiro.
`skipConfirmation`	String	No	Omite la pantalla de confirmación de importe y cuotas.
`skipReceipt`	String	No	Define si se imprime el recibo del cliente.
`allowPrintCurrentTransaction`	String	No	`"false"` devuelve los datos del recibo como `automationSlip`.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Resultado de la transacción. Consulta Códigos de resultado.
`resultDetails`	String	Mensaje detallado del resultado de la transacción.
`authorizationCode`	String	Código de autorización de la transacción.
`commerceCode`	String	Código único del comercio aprobado por Getnet.
`amount`	String	Valor revertido en moneda local.
`gmtDateTime`	String	Fecha y hora GMT (MMDDhhmmss, UTC 0).
`callerId`	String	Se corresponde con la solicitud del deeplink.
`nsuLastSuccesfullMessage`	String	Último NSU de Getnet generado con éxito.
`refundTransactionDate`	String	Fecha de la devolución.
`refundOriginTerminal`	String	Identificador del terminal de origen de la devolución.
`automationSlip`	String	Datos del recibo en formato JSON.

Preautorización

URI: getnet://payment/v1/pre-auth

Reserva fondos en una tarjeta de crédito para una captura posterior. El parámetro operation selecciona la acción del ciclo de vida. Consulta Crea un pago preautorizado.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`operation`	String	Sí	`"0"`: crear, `"1"`: modificar, `"2"`: eliminar, `"3"`: confirmar, `"4"`: consultar.
`reservation_id`	String	Condicional	Identifica la preautorización. Obligatorio para modificar, eliminar o confirmar. Coincide con el `authorizationRefCode` de la respuesta de creación.
`amount`	String	No	Valor en moneda local que se va a reservar.
`originalAmount`	String	No	Valor en moneda local para realizar la transacción.
`date`	String	No	Fecha de la transacción en formato `dd/MM/yyyy`.
`installments`	String	No	Cantidad de cuotas (solo tarjeta de crédito).
`plan_id`	String	No	ID del plan de cuotas. Consulta Reglas de cuotas.
`interest`	String	No	Indica si el plan incluye intereses (`true`/`false`).
`operationMode`	String	No	`"0"`: manual, `"1"`: calculado.
`skipConfirmation`	String	No	Omite la pantalla de confirmación.
`skipReceipt`	String	No	Omite la pantalla del recibo del cliente.
`callerId`	String	No	Se corresponde con la solicitud del deeplink.
`allowPrintCurrentTransaction`	String	No	`"false"` devuelve los datos del recibo como `automationSlip`.
`filterReservationId`, `filterInitialDate`, `filterFinalDate`, `filterAuthorizationCode`, `filterCardLastDigits`, `filterAllowedBrands`	String	No	Filtros para las preautorizaciones pendientes. Envíalos solo cuando `operation` es `"4"` (consultar).

Parámetros de respuesta

Campos clave: result, resultDetails, amount, originalAmount, authorizationRefCode (identificador de la preautorización), authorizationCode, nsu, nsuLastSuccesfullMessage, brand, inputType, cardBin (8 dígitos), cardLastDigits, paymentType, sellerCode, terminalCode, receiptCode, callerId, gmtDateTime, automationSlip y pendingAuthorizations (se completa solo en la operación de consulta).

Polling

URI: getnet://payment/v1/polling

Verifica que la Payment App esté lista para recibir comandos. No tiene parámetros de solicitud.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	`"0"` indica que el terminal está listo.
`resultDetails`	String	Mensaje detallado sobre el estado del terminal.

Reimpresión (última transacción)

URI: getnet://payment/v1/last-transaction

Reimprime o devuelve el último recibo.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`allowPrintCurrentTransaction`	String	No	`"false"` devuelve los datos del recibo como `automationSlip` en lugar de imprimirlos.
`skipReceipt`	String	No	`"true"` omite el recibo del cliente. Se rechaza si `allowPrintCurrentTransaction` es `"false"`.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Resultado de la transacción.
`resultDetails`	String	Mensaje detallado del resultado.
`automationSlip`	String	Datos del recibo en formato JSON. Vacío cuando `allowPrintCurrentTransaction` es `"true"`.

Reportes

URI: getnet://payment/v1/reports

Obtiene una lista detallada de ventas o un resumen de totales del lote actual.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`reportType`	String	Sí	`"0"`: ventas detalladas, `"1"`: total de ventas.
`allowPrintCurrentTransaction`	String	No	`"true"` imprime el reporte en el terminal; `"false"` solo devuelve los datos.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Resultado de la transacción.
`resultDetails`	String	Mensaje detallado del resultado.
`reportDetails`	String	Cadena JSON con el contenido del reporte. Consulta Códigos de resultado y estructuras de datos.

GetInfo

URI: getnet://payment/v1/get-info

Devuelve información técnica y operativa del terminal. No tiene parámetros de solicitud. La respuesta incluye result, resultDetails y los campos del terminal detallados en Códigos de resultado y estructuras de datos. Para hacer la llamada, consulta Obtén los datos del terminal y del comercio.

GetCommerceData

URI: getnet://payment/v1/commerce-data

Devuelve los datos de registro del comercio. No tiene parámetros de solicitud. La respuesta incluye result, resultDetails y un objeto JSON commerceData detallado en Códigos de resultado y estructuras de datos. Para hacer la llamada, consulta Obtén los datos del terminal y del comercio.

Turno

URI: getnet://payment/v1/shift

Configura, cambia u obtiene la información del turno. Para ver las tres operaciones paso a paso, consulta Administra los turnos de los operadores.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`shiftOperation`	String	Sí	`"1"`: configurar los turnos disponibles, `"2"`: cambiar al siguiente turno, `"3"`: obtener la cantidad actual de turnos.
`numberOfShifts`	String	No	Nueva cantidad de turnos cuando `shiftOperation` es `"1"`.
`skipConfirmation`	String	No	Omite la pantalla de confirmación del cambio de turno.
`allowPrintCurrentTransaction`	String	No	`"false"` devuelve los datos en lugar de imprimirlos.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Resultado de la transacción.
`resultDetails`	String	Mensaje detallado del resultado.
`totalOfShifts`	String	Cantidad actual de turnos. Se devuelve solo cuando `shiftOperation` es `"3"`.

Cancelar operación

URI: getnet://payment/v1/cancel-operation

Cancela una operación de deeplink en curso (Pago, Devolución o Preautorización). No tiene parámetros de solicitud. Consulta Cancela una operación en curso.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	`"6"` indica que la operación se canceló con éxito.
`resultDetails`	String	Mensaje detallado del resultado.

Consultar estado

URI: getnet://payment/v1/transaction-check-status

Busca el estado de una transacción de las últimas 72 horas por callerId. Consulta Consulta el estado de una transacción.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
`callerId`	String	Sí	ID de la transacción original (máx. 100). Sin caracteres especiales ni Unicode.

Parámetros de respuesta

Parámetro	Tipo	Descripción
`result`	String	Estado de la transacción. Consulta Códigos de resultado y estructuras de datos.
`resultDetails`	String	Mensaje del resultado de la transacción.
`callerId`	String	ID generado por la aplicación de terceros.
`authorizationCode`	String	Código de autorización de la transacción. Puede ser null si no se encontró ninguna transacción.