Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Standalone setup

Make your terminals ready for use as standalone devices.

To build a standalone solution, you need to follow the steps described in the integration checklist. Then, when you have finished testing, you need to follow the steps in the go-live checklist.

This page explains what you need to do when the checklists mentioned above tell you to "set up standalone".

Set up standalone

To set up the standalone feature in your Customer Area:

  1. Log in to your Customer Area.

  2. Go to Point of sale > Terminal settings > Integrations.

  3. Under Standalone, do the following:

    1. Enable standalone.
    2. In the Standalone currency box, select a currency for standalone transactions.
    3. Show or hide the Start button. When the Start button is hidden, you start a transaction by selecting the Confirm key on the keypad.
    4. Optional. Not supported on Android terminals. If you want to add a unique reference to each transaction, enter your Merchant reference using text and variables.

      You can use these unique references to reconcile transactions.

  4. Select Save.
    The terminal downloads configuration changes when it makes a maintenance call to our systems. This happens automatically every 180 minutes. The configuration changes then take effect when the terminal restarts. This happens automatically at the restart hour, which is usually set to 6:00 AM. If you don't want to wait for this, update the configuration on your terminal manually:

    The terminal downloads the updated configuration and then restarts.

  5. Optional. Contact our POS Support Team if you want to enable:

Set up standalone using an API call

You can use Management API to automate setting up the standalone feature for terminals at the company, merchant, store, or terminal level.

To set up the standalone feature using an API call:

  1. Use one of the following endpoints:

    Specify a standalone object with the following properties:

    Parameter Required Type Description
    enableStandalone -white_check_mark- boolean Set to true to enable standalone.
    currencyCode -white_check_mark- string The default currency of the standalone payment terminal as a three-digit ISO 4217 currency code.
    /terminalSettings request
    curl https://management-test.adyen.com/v1/companies/{companyId}/terminalSettings \
    -H "x-API-key: YOUR_X-API-KEY" \
    -X PATCH \
    -d '{
           "standalone" : {
               "enableStandalone": true,
               "currencyCode": "EUR"
           }
       }'
  2. The response returns all settings that your API credential has access to, including the enableStandalone value you set in the request.

    /terminalSettings response
    {
        "cardholderReceipt": {
            "headerForAuthorizedReceipt": "header1,header2,filler"
        },
        "gratuities": [],
        "nexo": {
            "encryptionKey": {
                "identifier": "KEY_IDENTIFIER",
                "passphrase": "KEY_PASSPHRASE",
                "version": 2
            },
            "eventUrls": {
                "eventPublicUrls": [
                    {
                        "password": "notification",
                        "url": "...",
                        "username": "adyen"
                    }
                ]
            },
            "nexoEventUrls": [
                "..."
            ]
        },
        "opi": {
            "enablePayAtTable": false,
            "payAtTableStoreNumber": "1111",
            "payAtTableURL": "..."
        },
        "receiptPrinting": {},
        "signature": {
            "askSignatureOnScreen": true,
            "skipSignature": true
        },
        "timeouts": {
            "fromActiveToSleep": 30
        },
        "offlineProcessing": {
            "chipFloorLimit": 0
        },
        "passcodes": {
            "adminMenuPin": "1111",
            "txMenuPin": "1111",
            "refundPin": "111111",
            "screenLockPin": "1111"
        },
        "standalone": {
            "enableStandalone": true,
            "currencyCode": "EUR"
        }
    }

Unreferenced refund passcode

Because unreferenced refunds on standalone payment terminals are risky, you can enable a 6-digit passcode needed to initiate the refund from the Transaction menu. To enable this, contact our POS Support Team.

To view or update the passcode for unreferenced refunds:

  1. In your Customer Area, go to Point of sale > Terminal settings or select a specific terminal by serial number.

    You can find the serial number in the Device info on the terminal.
    Refer to the manual for your terminal model.

  2. Select Passcodes.
  3. To view the passcode, under Terminal passcodes select Decrypted and at Unreferenced refunds select the view icon .
  4. To update the passcode, at Unreferenced refunds enter the new value, retype the new value, and select Save.
    The terminal downloads the new passcodes when it makes a maintenance call to our systems. This happens automatically every 180 minutes. The new passcodes then take effect when the terminal restarts. This happens automatically at the restart hour, which is usually set to 6:00 AM.

    To switch to the new passcode immediately, update the configuration on your terminal manually:

    • On a non-Android terminal, open the Admin menu and select Config > Update.
    • On an Android terminal, go to Settings > Configuration, enter your Settings passcode and select Update.

Testing

For information on how you can make test payments and refunds, see testing your integration.

Any test transactions you make, will appear in your Customer Area, under Transactions > Payments.