Skip to main content
POST
Register Terminal

授权

x-auth-token
string
header
必填

UQPAY 提供的登录 API Token。

请求头

x-client-id
string
必填

UQPAY 生成的 API 客户端 ID

x-idempotency-key
string<uuid>
必填

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

x-on-behalf-of
string

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

请求体

application/json
firm_code
enum<string>
必填

已启用的终端厂商代码。terminal_model 必须是所选厂商支持的型号。

当前支持的组合:

  • 01(Shengben):P1000P3
  • 02(Newland):N910N700T9
  • 03(Xinguodu):SP630SP530
  • 04(iMin):Swift 2Falcon 1
  • 05(PAX):A920A60

这些组合由 UQPAY 维护,可能会发生变化。请参阅 POS API 集成指南;如果你的型号未列出,请联系 UQPAY 技术支持。

可用选项:
01,
02,
03,
04,
05
示例:

"01"

firm_sn
string
必填

终端序列号

示例:

"SN123456789"

terminal_model
string
必填

所选 firm_code 支持的终端型号。请使用上方 firm_code 中支持组合所列的对应厂商型号。

示例:

"P1000"

响应

成功注册终端

create_time
string

创建时间

示例:

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

firm_sn
string

请求中提供的终端序列号

示例:

"TG676SX1764902333"

terminal_id
string

UQPAY 分配的唯一终端标识

示例:

"10000254"