Skip to main content
POST
Register Terminal

Authorizations

x-auth-token
string
header
required

UQPay 提供的登录 API Token。

Headers

x-client-id
string
required

UQPAY 生成的 API 客户端 ID

x-idempotency-key
string<uuid>
required

用于保持操作幂等性的唯一标识符(UUID),确保同一操作重复执行不会产生意外影响或重复结果。它有助于在网络错误、重试或故障时保持数据一致性。

x-on-behalf-of
string

指定代表哪个子账户发起该请求。应设置为 account_id,可通过 List Connected Accounts 获取。若省略或为空,则使用主账户执行请求。 更多信息见 Connected Accounts

Body

application/json
firm_code
enum<string>
required

终端厂商代码。

  • 01:Shengben
  • 02:Newland
  • 03:Xinguodu
  • 04:imin
  • 05:pax
Available options:
01,
02,
03,
04,
05
Example:

"01"

firm_sn
string
required

终端序列号

Example:

"SN123456789"

terminal_model
string
required

终端型号

Example:

"PAX A920"

Response

200 - application/json

成功注册终端

create_time
string

创建时间

Example:

"2025-12-05 10:38:53"

firm_sn
string

请求中提供的终端序列号

Example:

"TG676SX1764902333"

terminal_id
string

UQPAY 分配的唯一终端标识

Example:

"10000254"