Terminal statuses

Backoffice
API

Backoffice shows the status of each terminal in In-person payments > Terminals.

Status	Meaning	How it got there	Action
Pending	The terminal has been registered and is waiting to be provisioned.	You added the terminal, or an activation attempt is under way.	None. The status updates automatically.
Activate terminal	The terminal needs to fetch its configuration before it can be activated. Backoffice replaces the status with this button.	Dintero finished provisioning, or a configuration fetch was attempted and did not complete.	Click Activate terminal and follow the on-screen instructions. See terminal onboarding.
Activated	The terminal is provisioned and ready to accept payments.	The terminal fetched its configuration and confirmed it.	None.
Inactive	The device has been disabled and cannot take payments.	The device was disabled on the Dintero side.	Contact Dintero support. Re-enabling is not self-service.
Deleted	The terminal has been removed from the account.	You deleted the terminal.	None. Add the terminal again to reuse it.

If setting up the terminal failed and it does not reach Activated, delete the terminal and add it again, or contact Dintero support.

Check the current status with GET /v1/accounts/{aid}/terminals/{terminal_id}.

Status	Meaning	How it got there	Action
`PENDING`	The terminal has been registered and is waiting to be provisioned.	You registered the terminal, or an activation attempt is under way.	None. The status updates automatically.
`ACTION_REQUIRED`	The terminal needs to fetch its configuration before it can be activated.	Dintero finished provisioning, or a configuration fetch was attempted and did not complete.	Fetch the terminal settings
`ACTIVE`	The terminal is provisioned and ready to accept payments.	The terminal fetched its configuration and confirmed it.	None.
`INACTIVE`	The device has been disabled and cannot take payments.	The device was disabled on the Dintero side.	Contact Dintero support. Re-enabling is not self-service.
`ERROR`	Provisioning failed.	Something went wrong during setup that did not recover on its own.	Delete the terminal and register it again, or contact Dintero support.
`DELETED`	The terminal has been removed from the account.	You deleted the terminal.	None. Register the terminal again to reuse it.

Only an ACTIVE terminal can take a payment. Creating a session against a terminal in any other status fails with order.store.terminal_id: terminal is not active. Most terminal operations are restricted by status too - poll_terminal is the only one you can always send.

Check whether a terminal is reachable

The terminal status tells you how far the terminal got through provisioning, not whether it is online right now. To check that, send a poll_terminal operation. It pings the terminal without changing anything on the device, and can be sent no matter which status the terminal has.

Terminal tasks

These tasks are done on the physical terminal, on a terminal that already has been onboarded.

Service password

The Service menu asks for a password. It is a rotating code you can request from Dintero support.

Change the Wi-Fi network

Use this when moving a terminal to a new location or replacing the network.

Swipe ↑ Up and Tap the ☰ Menu icon twice to access the menu options.
Go to Innstillinger (Settings) > Service > enter the Service password > Nettverksinnstilling (Network & internet).
Select your Wi-Fi network and enter the password.

Fetch the terminal settings

Use this when the status is ACTION_REQUIRED. The terminal has not pulled its configuration yet.

Make sure the terminal is on a Wi-Fi network. See Change the Wi-Fi network.
Swipe ↑ Up and Tap the ☰ Menu icon twice to access the menu options
Go to Innstillinger (Settings) > Service > enter the service password > Hent Innstillinger (Get settings).
The terminal fetches the latest configuration, and automatically restarts.

Checkout Integration

Express Checkout

Payment Methods

Tokenization

Split Payout

In-Person Payments

Troubleshooting your terminal

Terminal statuses

Check whether a terminal is reachable

Terminal tasks

Service password

Change the Wi-Fi network

Fetch the terminal settings

​Terminal statuses

​Check whether a terminal is reachable

​Terminal tasks

​Service password

​Change the Wi-Fi network

​Fetch the terminal settings

Terminal statuses

Check whether a terminal is reachable

Terminal tasks

Service password

Change the Wi-Fi network

Fetch the terminal settings