Retail

Pair terminal

Initiates pairing with a terminal.

Depending on the merchant account configuration, when you add a terminal, you either need to request a pairing code or add a registration code. Some accounts may be configured to do both terminal setup options if the account is configured with multiple eligible gateways.

For more information on how to pair a terminal, see Pairing the terminal in Guides.

<!-- theme: warning -->

⚠️ Try It

To use the Try It feature for this endpoint, you must use the credentials for your Sandbox API user.

<div style="display:none;">

Request parameters

  • merchantId
  • terminalName

Response parameters

  • terminalName
  • pairingCode
  • expirationDate
  • key
</div>
post/pay/v3/pairTerminal

Request body

merchantIdstring required

The Nexio merchant ID (MID) to associate with the terminal.

terminalNamestring

The name of the terminal.

Example request

{
  "merchantId": "100039",
  "terminalName": "FrontDesk1"
}

Response

Success

terminalNameTerminalName — unresolved $ref
pairingCodestring

The code used to pair a physical terminal to a payment platform. It is valid for 60 seconds after generation.

expirationDatestring

The date and time at which the pairing code expires, formatted as an ISO-8601 date expressed in UTC.

keystring

USAePay's unique identifier for an instance of a specific terminal paired to the platform.

random-4611765RandomNnnn — unresolved $ref

Changes