甬易支付文档中心

主题

一码付订单同步 ​

接口描述 ​

该接口用于医院侧将订单同步到支付宝。

请求URL ​

  • /his/order/medicalPaymentOrderSync

请求方式 ​

  • POST

公共请求参数 ​

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

请求参数 ​

参数名必选类型最大长度说明示例
medicalOrgNo是string12定点医疗机构编码H320100001
medicalOrgName是string128定点医疗机构名称某某医院
medicalCode是string28用户医疗码2026042900000000000000000001
paymentCode是string24自费付款码280123456789012345678
paymentCityCode是string6就医所在地城市编码330100
bizType是string32业务类型：
OUTPATIENT_REGISTRATION-门诊挂号费
OUTPATIENT_PAYMENT-门诊缴费
HOSPITAL_DEPOSIT-住院预缴押金
HOSPITAL_SETTLEMENT-住院清算		OUTPATIENT_PAYMENT
tradeSubject是string256订单标题门诊缴费
optType是string32操作类型：SETTLE-支付SETTLE
tradeStatus是string32订单状态：SUCCESS-成功SUCCESS
outTradeNo是string32医院侧订单号ORDER_001
paidTime是string支付完成时间，格式：yyyy-MM-dd HH:mm:ss2026-04-29 15:30:00
alipayTradeNo否string64支付宝交易号2026042922001400001
alipayAmount否string支付宝支付金额，单位：分1000
medicalTradeNo是string64医保业务流水号MED202604290001
tradeAmount是string订单金额，单位：分5000
medicalAmount是string医保统筹基金支付金额，单位：分2000
medicalPersonalAmount是string医保个人账户支付金额，单位：分1500
ownPayAmount是string自费现金支付金额，单位：分1500
otherPayChannelStr否string其他支付渠道金额信息，JSON格式：
[{"channelType":"CASH","amount":"0.1"}]
channelType取值：CASH-现金，WECHAT_PAY-微信支付		[{"channelType":"CASH","amount":"100"}]
paymentPlace是string32支付场景：
CASHIER-收费窗口
DOCTOR_OFFICE-医生诊间
SELF_SERVICE_MACHINE-自助机		CASHIER
paymentPlaceCode否string64支付场景编号WIN001
serviceId否string64系统服务商PID，默认：20882218376213902088221837621390

请求报文示例 ​

json
{
  "appId": "202415629590370906",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "medicalOrgNo": "H320100001",
  "medicalOrgName": "某某医院",
  "medicalCode": "2026042900000000000000000001",
  "paymentCode": "280123456789012345678",
  "paymentCityCode": "330100",
  "bizType": "OUTPATIENT_PAYMENT",
  "tradeSubject": "门诊缴费",
  "optType": "SETTLE",
  "tradeStatus": "SUCCESS",
  "outTradeNo": "ORDER_001",
  "paidTime": "2026-04-29 15:30:00",
  "alipayTradeNo": "2026042922001400001",
  "alipayAmount": "1000",
  "medicalTradeNo": "MED202604290001",
  "tradeAmount": "5000",
  "medicalAmount": "2000",
  "medicalPersonalAmount": "1500",
  "ownPayAmount": "1500",
  "otherPayChannelStr": "[{\"channelType\":\"CASH\",\"amount\":\"100\"}]",
  "paymentPlace": "CASHIER",
  "paymentPlaceCode": "WIN001"
}

公共响应参数 ​

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

响应参数 ​

参数名必选类型最大长度说明示例
orderId是string上传成功后的平台订单Id20260429000000001

响应示例 ​

json
{
  "code": "000000000",
  "message": "成功",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "orderId": "20260429000000001"
}

备注 ​