# Deeplink Parameters Reference

This page provides a consolidated catalog of all App2App deeplink URIs and their request and response parameters. Communication with the Getnet Payment App is performed via Android Intents using specific URIs. All parameters are passed as `Extras` in the Intent.

## Available deeplinks

The Getnet Payment App exposes the following deeplinks:

| URI | Function |
| :--- | :--- |
| `getnet://payment/v1/payment` | Start a sales transaction. |
| `getnet://payment/v1/commerce-data` | Return merchant registration data. |
| `getnet://payment/v1/refund` | Initiate a refund. |
| `getnet://payment/v1/polling` | Check whether the Payment App can handle deeplinks. |
| `getnet://payment/v1/get-info` | Return terminal information. |
| `getnet://payment/v1/last-transaction` | Return or reprint the last receipt. |
| `getnet://payment/v1/reports` | Return reports. |
| `getnet://payment/v1/cancel-operation` | Cancel a deeplink operation currently in progress. |
| `getnet://payment/v1/shift` | Manage shifts. |
| `getnet://payment/v1/pre-auth` | Initiate a pre-authorization. |
| `getnet://payment/v1/transaction-check-status` | Search for the status of a specific previous transaction. |

<Callout type="note">

`getnet://payment/v1/last-transaction` is the production URI for reprinting or returning the last receipt. `getnet://payment/v1/reprint` is **not** an App2App deeplink in the `payment` scheme — do not use it. Samples that show it likely came from the BR scheme `getnet://pagamento/v1/reprint`, which is a different context.

</Callout>

## Payment

**URI:** `getnet://payment/v1/payment`

Initiates a new payment transaction. The `paymentMethod` parameter selects Card or QR Code.

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `amount` | String | Yes | Transaction total in cents, with two implicit decimals. Integer of up to 9 digits; leading zeros are tolerated but not required (e.g., `"1234"` = \$12.34; `"10000"` = \$100.00). |
| `originalAmount` | String | No | Value in local currency to perform the transaction. |
| `receiptCode` | String | Yes | ID printed on the receipt for merchant tracking. |
| `callerId` | String | No | Unique identifier to correlate request and response. |
| `tip` | String | No | Tip amount added to the transaction total. Same decimal format as `amount`. |
| `waiterCode` | String | Conditional | Waiter code for tip attribution. Required if a tip is provided. |
| `paymentMethod` | String | No | `"1"`: Card, `"2"`: QR Code. If omitted, the terminal shows the selection screen. |
| `installments` | Integer | No | Number of installments (credit card only). |
| `planId` | String | No | Installment plan ID. See [Installment Rules](/en/app2app/reference-a2a/installment-rules). |
| `interest` | Boolean | No | Whether the plan includes interest (`true`) or is interest-free (`false`). |
| `operationMode` | String | No | `"0"`: Manual, `"1"`: Calculated. See [Interest Calculation Strategy](/en/app2app/core-concept-a2a/interest-calculation-strategy). |
| `skipReceipt` | Boolean | No | `"true"` bypasses the customer receipt screen. Default `"false"`. |
| `skipConfirmation` | Boolean | No | `"true"` bypasses the amount/installment confirmation screen. Default `"false"`. |
| `allowPrintCurrentTransaction` | String | No | `"false"` returns receipt data as `automationSlip`. See [Printing Responsibility](/en/app2app/core-concept-a2a/printing-responsibility). |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction result. See [Result Codes](/en/app2app/reference-a2a/result-codes-data-structure). |
| `resultDetails` | String | Detailed message of the transaction result. |
| `amount` | String | Transaction amount in local currency. |
| `originalAmount` | String | Value in local currency to perform the transaction. |
| `tip` | String | Tip amount for the sale. |
| `waiterCode` | String | Waiter code for tip attribution. |
| `receiptCode` | String | Identification printed on receipt. |
| `callerId` | String | Correlates with the deeplink request. |
| `nsu` | String | Getnet transaction authorization code, unique per terminal per day. |
| `nsuLastSuccesfullMessage` | String | Last Getnet NSU successfully generated. |
| `paymentType` | String | Payment type (credit, debit, voucher, etc.). |
| `brand` | String | Card brand. |
| `inputType` | String | `021`: magnetic stripe, `051`: chip, `071`: contactless chip, `801`: magnetic stripe fallback. |
| `installments` | String | Number of installments. |
| `planId` | String | Installment plan selected. |
| `interest` | String | Whether interest was selected (`true`/`false`). |
| `gmtDateTime` | String | GMT date and time (MMDDhhmmss, UTC 0). |
| `authorizationCode` | String | Transaction authorization code. |
| `cardBin` | String | First 8 digits of the card. |
| `cardLastDigits` | String | Last 4 digits of the card. |
| `sellerCode` | String | Branch code approved by Getnet. |
| `terminalCode` | String | POS terminal code. |
| `paymentMethod` | String | `"1"`: Card, `"2"`: QR Code. |
| `automationSlip` | String | JSON receipt data. See [Printing Responsibility](/en/app2app/core-concept-a2a/printing-responsibility). |

## Refund

**URI:** `getnet://payment/v1/refund`

Reverses a previously approved transaction. Partial refunds are supported when the amount is less than the original.

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `authorizationCode` | String | Yes | Original transaction code found as "AUT" on the receipt. |
| `transactionDate` | String | Yes | Date of the original transaction in `dd/MM/yyyy` format. |
| `amount` | String | Yes | Value to be reversed. If less than the original, a partial refund is performed. |
| `refundType` | String | No | `"1"`: Sale withdrawal, `"2"`: Sale, `"3"`: Withdrawal. |
| `skipConfirmation` | String | No | Skips the amount/installment confirmation screen. |
| `skipReceipt` | String | No | Defines whether the client receipt is printed. |
| `allowPrintCurrentTransaction` | String | No | `"false"` returns receipt data as `automationSlip`. |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction result. See [Result Codes](/en/app2app/reference-a2a/result-codes-data-structure). |
| `resultDetails` | String | Detailed message of the transaction result. |
| `authorizationCode` | String | Transaction authorization code. |
| `commerceCode` | String | Unique merchant code approved by Getnet. |
| `amount` | String | Value reversed in local currency. |
| `gmtDateTime` | String | GMT date and time (MMDDhhmmss, UTC 0). |
| `callerId` | String | Correlates with the deeplink request. |
| `nsuLastSuccesfullMessage` | String | Last Getnet NSU successfully generated. |
| `refundTransactionDate` | String | Date of the refund. |
| `refundOriginTerminal` | String | Terminal identifier of the refund origin. |
| `automationSlip` | String | JSON receipt data. |

## Pre-authorization

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

Reserves funds on a credit card for a future capture. The `operation` parameter selects the lifecycle action. See [Create a Pre-authorized Payment](/en/app2app/payment-guides-a2a/create-preauth-payment).

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `operation` | String | Yes | `"0"`: create, `"1"`: modify, `"2"`: remove, `"3"`: confirm, `"4"`: retrieve. |
| `reservation_id` | String | Conditional | Identifies the pre-authorization. Required to modify, remove, or confirm. Matches `authorizationRefCode` from the create response. |
| `amount` | String | No | Value in local currency to reserve. |
| `originalAmount` | String | No | Value in local currency to perform the transaction. |
| `date` | String | No | Transaction date in `dd/MM/yyyy` format. |
| `installments` | String | No | Number of installments (credit card only). |
| `plan_id` | String | No | Installment plan ID. See [Installment Rules](/en/app2app/reference-a2a/installment-rules). |
| `interest` | String | No | Whether the plan includes interest (`true`/`false`). |
| `operationMode` | String | No | `"0"`: Manual, `"1"`: Calculated. |
| `skipConfirmation` | String | No | Skips the confirmation screen. |
| `skipReceipt` | String | No | Skips the customer receipt screen. |
| `callerId` | String | No | Correlates with the deeplink request. |
| `allowPrintCurrentTransaction` | String | No | `"false"` returns receipt data as `automationSlip`. |
| `filterReservationId`, `filterInitialDate`, `filterFinalDate`, `filterAuthorizationCode`, `filterCardLastDigits`, `filterAllowedBrands` | String | No | Filters for pending pre-authorizations. Send only when `operation` is `"4"` (retrieve). |

### Response parameters

Key fields: `result`, `resultDetails`, `amount`, `originalAmount`, `authorizationRefCode` (pre-authorization identifier), `authorizationCode`, `nsu`, `nsuLastSuccesfullMessage`, `brand`, `inputType`, `cardBin` (8 digits), `cardLastDigits`, `paymentType`, `sellerCode`, `terminalCode`, `receiptCode`, `callerId`, `gmtDateTime`, `automationSlip`, and `pendingAuthorizations` (populated only for the retrieve operation).

## Polling

**URI:** `getnet://payment/v1/polling`

Verifies that the Payment App is ready to receive commands. No request parameters.

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | `"0"` indicates the terminal is ready. |
| `resultDetails` | String | Detailed message about the terminal status. |

## Reprint (last transaction)

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

Reprints or returns the last receipt.

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `allowPrintCurrentTransaction` | String | No | `"false"` returns receipt data as `automationSlip` instead of printing. |
| `skipReceipt` | String | No | `"true"` skips the client receipt. Rejected if `allowPrintCurrentTransaction` is `"false"`. |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction result. |
| `resultDetails` | String | Detailed message of the result. |
| `automationSlip` | String | JSON receipt data. Empty when `allowPrintCurrentTransaction` is `"true"`. |

## Reports

**URI:** `getnet://payment/v1/reports`

Retrieves a detailed sales list or a totals summary for the current batch.

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `reportType` | String | Yes | `"0"`: Detailed sales, `"1"`: Total of sales. |
| `allowPrintCurrentTransaction` | String | No | `"true"` prints the report on the terminal, `"false"` returns data only. |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction result. |
| `resultDetails` | String | Detailed message of the result. |
| `reportDetails` | String | JSON string with the report content. See [Result Codes and Data Structures](/en/app2app/reference-a2a/result-codes-data-structure). |

## GetInfo

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

Returns technical and operational information about the terminal. No request parameters. The response includes `result`, `resultDetails`, and terminal fields detailed in [Result Codes and Data Structures](/en/app2app/reference-a2a/result-codes-data-structure). For the call itself, see [Get Terminal and Merchant Data](https://docs.globalgetnet.com/en/products/in-store-payments/app2app-integration?doc=get-terminal-and-merchant-data).

## GetCommerceData

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

Returns merchant registration data. No request parameters. The response includes `result`, `resultDetails`, and a `commerceData` JSON object detailed in [Result Codes and Data Structures](/en/app2app/reference-a2a/result-codes-data-structure). For the call itself, see [Get Terminal and Merchant Data](https://docs.globalgetnet.com/en/products/in-store-payments/app2app-integration?doc=get-terminal-and-merchant-data).

## Shift

**URI:** `getnet://payment/v1/shift`

Sets up, changes, or retrieves shift information. For the three operations step by step, see [Manage Operator Shifts](/en/app2app/operational-guides-a2a/manage-operator-shifts).

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `shiftOperation` | String | Yes | `"1"`: set up available shifts, `"2"`: change to next shift, `"3"`: retrieve current shift amount. |
| `numberOfShifts` | String | No | New shift amount when `shiftOperation` is `"1"`. |
| `skipConfirmation` | String | No | Skips the shift-change confirmation screen. |
| `allowPrintCurrentTransaction` | String | No | `"false"` returns data instead of printing. |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction result. |
| `resultDetails` | String | Detailed message of the result. |
| `totalOfShifts` | String | Current shift amount. Returned only when `shiftOperation` is `"3"`. |

## Cancel operation

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

Cancels a deeplink operation currently in progress (Payment, Refund, or Pre-authorization). No request parameters. See [Cancel an Operation in Progress](https://docs.globalgetnet.com/en/products/in-store-payments/app2app-integration?doc=cancel-an-operation-in-progress).

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | `"6"` indicates the operation was successfully canceled. |
| `resultDetails` | String | Detailed message of the result. |

## Check status

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

Searches for the status of a transaction from the last 72 hours by `callerId`. See [Check a Transaction Status](https://docs.globalgetnet.com/en/products/in-store-payments/app2app-integration?doc=check-a-transaction-status).

### Request parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `callerId` | String | Yes | ID of the original transaction (max 100). No special or Unicode characters. |

### Response parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
| `result` | String | Transaction status. See [Result Codes and Data Structures](/en/app2app/reference-a2a/result-codes-data-structure). |
| `resultDetails` | String | Message of the transaction result. |
| `callerId` | String | ID generated by the third-party application. |
| `authorizationCode` | String | Transaction authorization code. May be null if no transaction was found. |