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/settlement.md.
  • English
  • Settlement (Shift)

    Push settlement (shift) instructions to payment terminals to complete daily settlement operations.

    API Information

    • Endpoint: POST https://api.aimt-horizon.com/mis/shift
    • Signature: Uses terminal_sn + terminal_key

    Request Parameters

    ParameterTypeRequiredDescription
    terminal_snString(32)YesTerminal SN bound to the source system
    target_device_idString(20)YesTarget payment device ID (e.g., TUSN on the back of the terminal)

    Shift Request

    {
      "terminal_sn": "2101107140290972547",
      "target_device_id": "TUSN12345678"
    }

    Use only on enabled devices. This API does not provide a verified universal shift-result query endpoint; validate completion using the device or agreed channel result.

    Response (Command Accepted)

    {
      "result_code": "200",
      "error_message": null,
      "error_code": null,
      "biz_response": {
        "result_code": "MIS_PUSH_SUCCESS",
        "error_code": null,
        "error_message": null
      }
    }

    Response Example (Failure)

    {
      "result_code": "200",
      "error_message": null,
      "error_code": null,
      "biz_response": {
        "result_code": "MIS_PUSH_FAIL",
        "error_code": "MIS_PUSH_FAIL",
        "error_message": "Push failed"
      }
    }
    Key Points
    • Settlement operations are typically performed at end of business day.
    • Ensure all transactions for the day have been processed before initiating settlement.
    • MIS_PUSH_SUCCESS acknowledges the shift command only. No general shift-result query or summary callback is confirmed for these APIs; verify completion on the device. This is not fund settlement.