Input Parameters Reference
Pass optional parameters via the EXTRA_PARAMETERS HashMap<String, String> extra, unless otherwise noted.
Transaction identification
Parameter | Type | Description |
|---|---|---|
| | Transaction amount in minor units (e.g. $10.00 → |
| | Transaction type enum. Set directly on the intent. |
| String | Your own reference ID attached to the result for reconciliation. |
| String | Terminal reference ID. Auto-generated (UUID) if not provided. |
| String | Unique Transaction Identifier — use to target a specific existing transaction. |
| String | Transaction description printed on the receipt. |
| String | Name of your application, shown in diagnostic logs. |
Merchant & multi-merchant
Parameter | Type | Description |
|---|---|---|
| String | Merchant ID to use for this transaction. Required when multi-merchant is enabled. |
Transaction behaviour
Parameter | Type ( | Description |
|---|---|---|
| Boolean string | Suppress receipt printing. Default: |
| Boolean string | Force receipt printing regardless of terminal print settings. |
| Boolean string | Skip signature verification step. |
| Boolean string | Automatically accept the signature without operator confirmation. |
| Boolean string | Require merchant password before processing a refund. |
| Boolean string | Show UI for completion/cancel-preauth operations. Default: |
| Long string | Milliseconds Core waits on the result screen before returning control to your app. |
| String | Override the display language for this operation only (e.g. |
Tip & cashback
Parameter | Type | Description |
|---|---|---|
| Long string | Pre-set tip amount in minor units. |
| Long string | Cashback amount in minor units. |
| Boolean string | Show tip prompt to the customer. |
Card filtering
Parameter | Type | Description |
|---|---|---|
| String | Comma-separated BIN prefixes. Only cards matching these BINs are accepted. |
| String | Comma-separated EMV AIDs. Only applications matching these AIDs are accepted. |
Pre-auth completion / cancel
Parameter | Type | Description |
|---|---|---|
| String | First 6 digits of the PAN from the original pre-auth. |
| String | Last 4 digits of the PAN from the original pre-auth. |
| String | Authorization code from the original pre-auth result. |
| String | Message ID from the original pre-auth result. |
| String | Full PAN length. Defaults to |
| Boolean string | Set to |
Top-up continuation
Parameter | Type | Description |
|---|---|---|
| String | Message ID from the original |
| String | Auth code from the original |
External approval flow
Parameter | Type | Description |
|---|---|---|
| Boolean string | Pause transaction after card read and wait for |
| Boolean string | Automatically void the transaction if approval is not received in time. |
| Boolean string | Approval decision sent via |
Offline / deferred mode
Parameter | Type | Description |
|---|---|---|
| Boolean | Activate ( |
Mastercard benefit / voucher (DE124)
Parameter | Type | Description |
|---|---|---|
| String | Mastercard DE124, positions 5–6. |
| String | Mastercard DE124, positions 7–99. |
Device-specific
Parameter | Type | Description |
|---|---|---|
| String | Set to |
| String | NFC URL for QR scanning integration. |