甬易支付文档中心

主题

订单查询 ​

接口描述 ​

根据订单号或平台流水号查询医院订单的详细信息，支持普通订单、退款订单和提现订单三种类型的查询。

请求URL ​

  • /his/order/query

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用ID202415629590370906
signature是string签名
transNonce是string32请求流水号43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
tradeNo否string32支付接口返回的甬易订单号，与商户侧订单号二者不能同时为空XS20260423000001
outTradeNo否string32商户侧订单号，与支付接口返回的甬易订单号二者不能同时为空ORDER_001
orderKind是string订单类别：1-普通订单 2-退款订单 3-提现订单1

请求报文示例 ​

json
{
  "appId": "202415629590370906",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "tradeNo": "XS20260423000001",
  "outTradeNo": "ORDER_001",
  "orderKind": "1"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码：000000000-成功，非000000000-失败，具体原因取message00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate是string13响应时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
outTradeNo是string32商户侧订单号ORDER_001
tradeNo是string32甬易订单号XS20260423000001
merchantNo是string32商户编号XS240820000054
tradeAmount是string20订单金额，单位：分10000
currencyType是string支付币种，取值："CNY"，目前只支持使用人民币（CNY）支付CNY
tradeTime是string交易成功时间，格式为：YYYYMMDDHHmmss20260423153000
tradeStatus是string订单状态：INIT-待支付 SUCCESS-成功 FAIL-失败SUCCESS
bankId是string渠道编码B001
orderType是string订单类型，RECHARGE-充值 PAY-消费 REFUND-退款 REFUND-线上退款到卡（特殊处理为REFUND） REFUND-线下退款到卡（特殊处理为REFUND） WITHDRAW-提现 SETTLEMENT-结算 FEE-手续费 PROFIT-分润 ADJUSTMENT-调账PAY
remark否string备注挂号费

响应示例 ​

json
{
  "code": "00000000",
  "message": "成功",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "outTradeNo": "ORDER_001",
  "tradeNo": "XS20260423000001",
  "merchantNo": "XS240820000054",
  "tradeAmount": "10000",
  "currencyType": "CNY",
  "tradeTime": "20260423153000",
  "tradeStatus": "SUCCESS",
  "bankId": "B001",
  "orderType":"PAY",
  "remark": "挂号费"
}

备注 ​