---
title: "Input Parameters Reference"
source_url: https://docs.rapyd.net/en/input-parameters-reference.html
lang: en
---

# Input Parameters Reference

Pass optional parameters via the `EXTRA_PARAMETERS` `HashMap<String, String>` extra, unless otherwise noted.

### Transaction identification

| Parameter | Type | Description |
| --- | --- | --- |
| `AMOUNT` | `long` | Transaction amount in minor units (e.g. $10.00 → `1000`). Set directly on the intent, not in `EXTRA_PARAMETERS`. |
| `TRANS_TYPE` | `TransactionType` | Transaction type enum. Set directly on the intent. |
| `CORRELATION_ID` | String | Your own reference ID attached to the result for reconciliation. |
| `REFERENCE_ID` | String | Terminal reference ID. Auto-generated (UUID) if not provided. |
| `UTI` | String | Unique Transaction Identifier — use to target a specific existing transaction. |
| `DESCRIPTION` | String | Transaction description printed on the receipt. |
| `INTEGRATOR_NAME` | String | Name of your application, shown in diagnostic logs. |

### Merchant & multi-merchant

| Parameter | Type | Description |
| --- | --- | --- |
| `MERCHANT_ID` | String | Merchant ID to use for this transaction. Required when multi-merchant is enabled. |

### Transaction behaviour

| Parameter | Type (`"true"`/`"false"`) | Description |
| --- | --- | --- |
| `DISABLE_PRINTING` | Boolean string | Suppress receipt printing. Default: `"false"`. |
| `FORCE_PRINT` | Boolean string | Force receipt printing regardless of terminal print settings. |
| `DISABLE_SIGNATURE_VERIFICATION` | Boolean string | Skip signature verification step. |
| `AUTO_COMPLETE_SIGNATURE` | Boolean string | Automatically accept the signature without operator confirmation. |
| `REFUND_WITH_PASSWORD` | Boolean string | Require merchant password before processing a refund. |
| `SHOW_UI` | Boolean string | Show UI for completion/cancel-preauth operations. Default: `"true"`. Set to `"false"` for silent operation. |
| `TIME_TO_LEAVE` | Long string | Milliseconds Core waits on the result screen before returning control to your app. |
| `LOCALE` | String | Override the display language for this operation only (e.g. `"en_GB"`, `"is_IS"`). |

### Tip & cashback

| Parameter | Type | Description |
| --- | --- | --- |
| `TIP_AMOUNT` | Long string | Pre-set tip amount in minor units. |
| `CASHBACK_AMOUNT` | Long string | Cashback amount in minor units. |
| `PROMPT_TIPS` | Boolean string | Show tip prompt to the customer. |

### Card filtering

| Parameter | Type | Description |
| --- | --- | --- |
| `BIN_WHITELIST` | String | Comma-separated BIN prefixes. Only cards matching these BINs are accepted. |
| `AID_WHITELIST` | String | Comma-separated EMV AIDs. Only applications matching these AIDs are accepted. |

### Pre-auth completion / cancel

| Parameter | Type | Description |
| --- | --- | --- |
| `PAN_FIRST_SIX` | String | First 6 digits of the PAN from the original pre-auth. |
| `PAN_LAST_FOUR` | String | Last 4 digits of the PAN from the original pre-auth. |
| `AUTH_CODE` | String | Authorization code from the original pre-auth result. |
| `MESSAGE_ID` | String | Message ID from the original pre-auth result. |
| `CARD_LENGTH` | String | Full PAN length. Defaults to `"16"` if omitted. |
| `CANCEL_PREAUTH` | Boolean string | Set to `"true"` to cancel instead of complete. Automatically set by `cancelPreAuth`. |

### Top-up continuation

| Parameter | Type | Description |
| --- | --- | --- |
| `TOPUP_MESSAGE_ID` | String | Message ID from the original `TOPUP` transaction. |
| `TOPUP_AUTH_CODE` | String | Auth code from the original `TOPUP` transaction. |

### External approval flow

| Parameter | Type | Description |
| --- | --- | --- |
| `WAIT_FOR_APPROVAL` | Boolean string | Pause transaction after card read and wait for `sendApprovalResult`. |
| `AUTO_VOID_ON_APPROVAL_TIMEOUT` | Boolean string | Automatically void the transaction if approval is not received in time. |
| `APPROVE_TRANSACTION_RESULT` | Boolean string | Approval decision sent via `sendApprovalResult`. Do not set manually. |

### Offline / deferred mode

| Parameter | Type | Description |
| --- | --- | --- |
| `ACTIVATE_DEFERRED_MODE` | Boolean | Activate (`true`) or deactivate (`false`) manual deferred mode. Set via `triggerManualOfflineMode`. |

### Mastercard benefit / voucher (DE124)

| Parameter | Type | Description |
| --- | --- | --- |
| `BENEFIT_PROGRAM_MANAGER_ID` | String | Mastercard DE124, positions 5–6. |
| `VOUCHER_CODE` | String | Mastercard DE124, positions 7–99. |

### Device-specific

| Parameter | Type | Description |
| --- | --- | --- |
| `MODEL` | String | Set to `"A8700"` when running on a PAX A8700 dual-display device. |
| `NFC_URL` | String | NFC URL for QR scanning integration. |