For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/api/activate.md.
  • 简体中文
  • 终端激活

    首次注册 ISV 调用方终端,获取接口凭证。目标支付设备的绑定是独立的准备步骤。

    接口信息

    • 接口地址: POST https://api.aimt-horizon.com/terminal/activate
    • 签名凭证: 使用 vendor_sn + vendor_key

    请求参数

    参数类型是否必填说明
    app_idString是应用 ID
    codeString是激活码(在商户平台生成)
    device_idString(128)是设备唯一 ID,例如 "MERCHANT_STORE_01"
    client_snString(50)否第三方终端编号
    nameString(128)否终端显示名称
    os_infoString(45)否操作系统信息,例如 "Android 10"

    激活请求示例

    服务端以 vendor_sn / vendor_key 签名;device_id 是调用方标识,不自动替代目标支付设备 TUSN。可选 sdk_version 为 SDK 版本字符串。成功响应还可能返回 merchant_sn、merchant_name、store_sn、store_name;保留归属信息以核对设备绑定。

    {
      "app_id": "EXAMPLE_APP_ID",
      "code": "EXAMPLE_ACTIVATION_CODE",
      "device_id": "ISVSTORE01REGISTER01",
      "name": "Checkout 01"
    }

    响应

    {
      "result_code": "200",
      "biz_response": {
        "terminal_sn": "10298371039",
        "terminal_key": "EXAMPLE_TERMINAL_KEY"
      }
    }
    注意

    将 terminal_sn / terminal_key 加密持久化;不要用重复激活恢复支付超时。激活码有效期、设备重复激活与解绑规则需在开户时确认。示例凭证均为虚构值。