Retry terminal sync
Retry a terminal sync after it failed.
You can retry a terminal with status ERROR and status_reason SYNC_ERROR. You can also retry a terminal with status PENDING and status_reason ADDING that has waited for more than 10 minutes. The terminal moves to PENDING with status_reason ADDING, and Dintero runs the sync again. The status then updates on its own. If the sync fails again, the terminal goes back to ERROR with SYNC_ERROR.
A terminal in any other state is rejected with 409 TERMINAL_NOT_RETRYABLE. This includes a second request while the retry is running.
Fails with 400 STORE_NOT_ACTIVE if the terminal’s store is not ACTIVE.
scopes:
- admin:accounts
- write:accounts
Authorizations
Bearer authentication (token authentication) should be used for accessing the API.
Use Get Token to get an access token for client credentials. Pass the token in the request header:
where the access_token is JSON Web Tokens (JWT).
Path Parameters
Response
Terminal
Hardware model of the terminal.
SATURN1000— Saturn S1F2Saturn_S1F4_Pro— Saturn S1F4 ProS1P2— Saturn S1P2S1MINI2— Saturn S1MINI2S1U2— Saturn S1U2SIMULATED— Simulated terminal (sandbox accounts only)
SATURN1000, Saturn_S1F4_Pro, S1P2, S1MINI2, S1U2, SIMULATED How far the terminal has got through setup, and whether it can take payments. Only an ACTIVE terminal can be used for a payment; a session referencing a terminal in any other status is rejected.
This says nothing about whether the terminal is online right now - for that, send a poll_terminal terminal operation.
PENDING: The terminal has been registered and Dintero is configuring it. No action needed, the status updates on its own. Seestatus_reasonfor what is currently happening.ACTION_REQUIRED: Dintero has finished its side, and the terminal now has to fetch its configuration from its own on-screen menu before it can be activated. Also set when a configuration fetch was attempted and did not complete, in which case fetch the settings again.ACTIVE: The terminal is configured and ready to accept payments.INACTIVE: The device has been disabled and cannot take payments. Re-enabling it is not self-service - contact Dintero support.ERROR: Setting up the terminal failed. Withstatus_reasonSYNC_ERROR, retry the sync withPOST /v1/accounts/{aid}/terminals/{terminal_id}/sync. If the retry fails again, contact Dintero support.DELETED: The terminal has been removed from the account. Register the terminal again to reuse it.
DELETED, PENDING, ACTION_REQUIRED, ACTIVE, INACTIVE, ERROR Context explaining why the terminal has its current status.
Applies to terminals with status PENDING:
ADDING: the terminal is being registered and configured to Dintero.ACTIVATING: the terminal is being activated.
Applies to terminals with status ACTION_REQUIRED:
START_ACTIVATION: an activation task should be run to activate the terminal, usingPOST /admin/terminals/{terminal_id}/activations.
Applies to terminals with status ERROR:
SYNC_ERROR: syncing the terminal with the terminal provider failed. Retry the sync withPOST /v1/accounts/{aid}/terminals/{terminal_id}/sync.
ADDING, ACTIVATING, START_ACTIVATION, SYNC_ERROR