甬易支付文档中心

主题

支付下单 ​

接口描述 ​

供医院HIS系统进行支付调用，仅进行支付动作，不进行患者账户余额操作。

请求URL ​

  • /his/order/pay

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用ID，甬易提供，一个固定的值202415629590370906
signature是string签名
transNonce是string32请求流水号43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
outTradeNo是string32订单号，商户平台侧订单号ORDER_001
tradeAmount是string20支付金额,单位分10000
tradeSubject是string255订单主题苹果手机
notifyUrl是string255异步通知URLhttps://example.com/notify
returnUrl否string255支付成功后返回URLhttps://example.com/return
remark否string255备注挂号费
payerIp否string32客户IP地址192.168.1.1
expireTime是string过期时间2026-04-23 18:00:00
wxAppId否string微信AppId，交易支持使用商户自己的wxAppIdwx1234567890
openId否string微信用户openId，交易支持使用商户自己的wxAppIdo1234567890
authCode否string用户付款码授权码。付款码场景该字段必填（设备扫码获取的授权码）；扫脸支付场景该值为商户平台唤起扫脸采集和认证后获取到的ftoken288912345678901234
terminalNo否string用户终端号，付款码场景该字段必填T001
payProduct是string支付产品：JSAPI-jsapi支付 APP-app支付 H5-h5支付 NATIVE-native支付 MICROPAY-付款码支付 FACE-扫脸支付JSAPI
payBrand是string支付品牌：ALI_MINI_PROGRAM-支付宝小程序 ALI_APP-支付宝App ALI_LIFE-支付宝生活号 WX_MINI_PROGRAM-微信小程序 WX_OFFICIAL_ACCOUNT-微信公众号 WX_APP-微信AppWX_MINI_PROGRAM
longitude否string经度116.407425
latitude否string纬度39.90425

请求报文示例 ​

json
{
  "appId": "202415629590370906",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "outTradeNo": "ORDER_001",
  "tradeAmount": 100.00,
  "tradeSubject": "医院挂号",
  "notifyUrl": "https://example.com/notify",
  "returnUrl": "https://example.com/return",
  "remark": "挂号费",
  "payerIp": "192.168.1.1",
  "expireTime": "2026-04-23 18:00:00",
  "wxAppId": "wx1234567890",
  "openId": "o1234567890",
  "authCode": "",
  "terminalNo": "",
  "payProduct": "JSAPI",
  "payBrand": "WX_MINI_PROGRAM",
  "longitude": "116.407425",
  "latitude": "39.90425"
}

公共响应参数 ​

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

响应参数 ​

参数名必选类型最大长度说明示例
outTradeNo是string32医院侧订单号，同入参outTradeNoORDER_001
tradeNo是string32甬易订单号XS20260423000001
qrCode否string二维码URL，扫码支付场景必须返回https://pay.xspay.com/qr/xxx
payInfo否string支付参数信息，公众号、小程序、生活号等JSAPI方式返回的支付参数，用于唤起App
bankId是stringBankIdB001

响应示例 ​

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",
  "qrCode": "",
  "payInfo": "",
  "bankId": "B001"
}

备注 ​