Background
Instant Systems (IS) have integrated Adyen POS devices for their Cooler and Store products. The integration is built using Nexo-integration and involves both kiosk software and backend API. Instant Systems can PreAuth, PreAuthAdjust, Completions, VOIDs and Refunds. All Adyen supported devices should be supported, but please consult with your assigned KAM before selecting device. Mounting plates to the kiosks might vary.
Adyen Configuration
Pre-requisit: Merchant created with Adyen
Adyen specific configurations
Send to Adyen support since they’re the only one who can enable these
| Setting | Optional | Description |
| adjustAuthorisationData | NO | To allow PreAuthAdjust |
| recurringDetailReference | YES | Makes Adyen provide token, requires ForcePin consult IS and Adyen before enabling |
- Important! adjustAuthorisationData is not optional, meaning it is mandatory to allow
that the preauth can be adjusted.
Settings
These are set by operator in Adyen Portal
Under Settings -> Account settings set:
- Capture Delay = Immediate
- POS Capture Delay = Manual (not necessary since we also add manualCapture=true to AquireData on PreAuth requests)
Under Settings -> Checkout settings set:
- Recurring = True
Under Developers -> API Credentials -> ws ser
- Allowed IP range:
212.247.47.11/32
Additional data
Developers -> Additional data – Check below values
- Acquirer result
- Card bin
- Card summary
- Expiry date
- Funding source
- Variant
- Recurring details (not for POS)
-
Include alias info
Terminal Encryption
These are set by operator in Adyen Portal
Under Point of sale -> Terminal settings -> Integrations -> Encryption key set:
New Encryption Key;
- Key identifier: DefaultKey
- Key passphrase: c7ztAdM8akZ!V1PN%%$nzSgvROOs*&C0
- Key version: 2
Old Encryption Key:
- Key identifier = DefaultKey
- Key passphrase = 86f5e94937a9e99b7ae7f2b90109aed6
- Key version = 1
Should you want to use a propriatery key/passphrase pair that is possible. Please contact support@instantsystems.se for details how to configure it in Instant Systems admin.
Data that needs to be collected for use in Instant Systems
These are found by the operator in Adyen Portal.
- Merchant Account
Go to: Developers -> API URLs
- URL for Classic API
- URL for Checkout API
Go to: Developers -> API Credentials -> ws
- API Key
- Client Key
-
Client Encryption Public Key
Recommendations
Enable Smart Pre-Auth to avoid cards that doesn’t support auth adjustments
Kiosk Settings:
These are set in Instant Systems backend under Network -> Settings -> Kiosk Settings
Please consult with assigned Instant Systems KAM for questions or help
| Setting | Description |
| ChipAndPinPortConfig |
Pipe separated combination of values Possible values: DisplayNoAmount - Special flow to not display amount for authorize(deprecated) NoTokenize – For the old Terminal Encryption Key Passphrase Do not create a card token (which likely have a higher cost) example: DisplayNoAmount|NoTokenize
|
| ChipAndPinProviderID | Adyen API Key, and Client Key. Separated by a space example: SomeLongTextWithRandomSymbolsAndLettersAndDigitsNotBase64 live_SOMESHORTERTEXT |
| ChipAndPinProviderURL |
Information to help system know that this kiosk uses Adyen, which api version to target, and api url prefix (not required for test). Separated by a space example (test): adyen 68 example (live): adyen 68 1234-myliveaccounturl-
|
| ChipAndPinTransactionKey | Adyen merchant account name example: myaccountname-POS |
| ChipAndPinTestValuesEnabled | True or False, if we should target Adyen test endpoints or not |