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.

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.

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

Response parameters

Parameter	Type	Description
`result`	String	Transaction result. See Result Codes.
`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.

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

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

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. For the call itself, see 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. For the call itself, see 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.

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.

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.

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