# 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. |

<Callout type="note">

`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.

</Callout>

## 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](/es/app2app/reference-a2a/installment-rules). |
| `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](/es/app2app/core-concept-a2a/interest-calculation-strategy). |
| `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](/es/app2app/core-concept-a2a/printing-responsibility). |

### Parámetros de respuesta

| Parámetro | Tipo | Descripción |
| :--- | :--- | :--- |
| `result` | String | Resultado de la transacción. Consulta [Códigos de resultado](/es/app2app/reference-a2a/result-codes-data-structure). |
| `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](/es/app2app/core-concept-a2a/printing-responsibility). |

## 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](/es/app2app/reference-a2a/result-codes-data-structure). |
| `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](/es/app2app/payment-guides-a2a/create-preauth-payment).

### 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](/es/app2app/reference-a2a/installment-rules). |
| `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](/es/app2app/reference-a2a/result-codes-data-structure). |

## 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](/es/app2app/reference-a2a/result-codes-data-structure). Para hacer la llamada, consulta [Obtén los datos del terminal y del comercio](https://docs.globalgetnet.com/es/products/in-store-payments/app2app-integration?doc=get-terminal-and-merchant-data).

## 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](/es/app2app/reference-a2a/result-codes-data-structure). Para hacer la llamada, consulta [Obtén los datos del terminal y del comercio](https://docs.globalgetnet.com/es/products/in-store-payments/app2app-integration?doc=get-terminal-and-merchant-data).

## 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](/es/app2app/operational-guides-a2a/manage-operator-shifts).

### 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](https://docs.globalgetnet.com/es/products/in-store-payments/app2app-integration?doc=cancel-an-operation-in-progress).

### 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](https://docs.globalgetnet.com/es/products/in-store-payments/app2app-integration?doc=check-a-transaction-status).

### 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](/es/app2app/reference-a2a/result-codes-data-structure). |
| `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. |