For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /api/activate.md.
  • English
  • Activation

    Register the ISV caller to obtain API credentials. Binding the target payment device is a separate prerequisite.

    API Information

    • Endpoint: POST https://api.aimt-horizon.com/terminal/activate
    • Signature: Uses vendor_sn + vendor_key

    Request Parameters

    ParameterTypeRequiredDescription
    app_idStringYesApplication ID
    codeStringYesActivation code (generated on merchant platform)
    device_idString(128)YesUnique device ID, e.g. "MERCHANT_STORE_01"
    client_snString(50)NoThird-party terminal number
    nameString(128)NoTerminal display name
    os_infoString(45)NoOS info, e.g. "Android 10"

    Activation Request

    Sign server-side with vendor_sn / vendor_key. device_id identifies the caller and does not replace the payment device TUSN. Optional sdk_version is a version string. Success can also return merchant_sn, merchant_name, store_sn and store_name; retain ownership details for binding checks.

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

    Response

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

    Persist terminal_sn / terminal_key securely. Do not reactivate to recover a payment timeout. Confirm activation-code expiry, reactivation and unbinding rules during onboarding. Example credentials are fictional.