主题
异步通知
接口描述
该功能用于异步通知医院HIS系统用户支付结果。医院HIS支付时传入notifyURL，甬易侧订单支付完成后，会触发回调该URL，将支付结果同步给商户平台。
请求URL
- 商户支付时传入的notifyURL
请求方式
- POST
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码：000000000-成功，非000000000-失败，具体原因取message | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
| outTradeNo | 是 | string | 商户平台交易流水号 | ORDER_001 | |
| tradeNo | 是 | string | 甬易系统交易流水号 | XS20260423000001 | |
| merchantNo | 是 | string | 商户号 | XS240820000054 | |
| tradeSubject | 是 | string | 交易标题 | 苹果手机 | |
| tradeAmount | 是 | string | 交易金额，单位分 | 10000 | |
| tradeStatus | 是 | string | 交易状态：1-支付成功 2-支付失败 | 1 | |
| payFinishTime | 否 | string | 支付完成时间 | 2026-04-23 15:30:00 | |
| bankId | 是 | string | BankId | B001 |
请求报文示例
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",
"tradeSubject": "医院挂号",
"tradeAmount": "10000",
"tradeStatus": "1",
"payFinishTime": "2026-04-23 15:30:00",
"bankId": "B001"
}响应参数
商户平台接收到回调后，需返回字符串 SUCCESS，甬易平台收到该返回便认为接入方已收到通知。
响应示例
SUCCESS注意事项
- 甬易平台可能同一笔订单进行多次结果通知，商户平台需要做好幂等处理
- 商户平台接收到回调后，需要对通知内容做签名验证，防止数据被篡改
- 商户平台接收到回调后，需要返回SUCCESS，否则甬易平台将继续发送通知，以递增时间间隔重复发送5次，时间间隔分别为：24s、1m、1m、6m、12m
备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述