甬易支付文档中心

主题

汇聚码下单 ​

接口描述 ​

医院his系统调用本接口获取到聚合码授权url后，展示成二维码供患者扫码

请求URL ​

  • /his/order/aggregateCodeApply

请求方式 ​

  • POST

公共请求参数 ​

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

请求参数 ​

参数名必选类型最大长度说明示例
outTradeNo是string32商户订单号ORDER_001
tradeAmount是number20交易金额(单位分)100.00
tradeSubject是string255交易主题医院挂号
payerIp否string32付款人Ip127.0.0.1
notifyUrl否string255回调地址https://example.com/notify
returnUrl否string255前端回跳地址https://example.com/return
expireTime否string过期时间1800
remark否string255备注挂号费
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": "医院挂号",
  "payerIp": "127.0.0.1",
  "notifyUrl": "https://example.com/notify",
  "returnUrl": "https://example.com/return",
  "expireTime": "2026-04-23 18:00:00",
  "remark": "挂号费",
  "longitude": "116.407425",
  "latitude": "39.90425"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13响应时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
outTradeNo是string32商户订单号ORDER_001
approvalUrl是string聚合码链接https://pay.xspay.com/approval/xxx

响应示例 ​

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",
  "approvalUrl": "https://pay.xspay.com/approval/xxx"
}

备注 ​