Assign terminals
Assigns one or more payment terminals to a merchant account or a store. You can also use this endpoint to reassign terminals between merchant accounts or stores, and to unassign a terminal and return it to company inventory.
Request Parameters
Your company account. To return terminals to the company inventory, specify only this parameter and the terminals.
Name of the merchant account. Specify this parameter to assign terminals to this merchant account or to a store under this merchant account.
Boolean that indicates if you are assigning the terminals to the merchant inventory. Do not use when assigning terminals to a store. Required when assigning the terminal to a merchant account.
-
Set this to true to assign the terminals to the merchant inventory. This also means that the terminals cannot be boarded.
-
Set this to false to assign the terminals to the merchant account as in-store terminals. This makes the terminals ready to be boarded and to process payments through the specified merchant account.
The store code of the store that you want to assign the terminals to.
Array containing a list of terminal IDs that you want to assign or reassign to the merchant account or store, or that you want to return to the company inventory.
For example, ["V400m-324689776","P400Plus-329127412"].
Response parameters
After submitting a call, you receive a response message to inform you that your request was received and processed.
Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.