Skip to main content

Documentación

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.