主题
医保支付 FunctionCode | 暂无
该接口为平台在医保订单中自费部分支付成功后,主动向调用方(如医院或服务平台)推送的异步通知。通知内容包括订单支付状态、自费金额、支付时间等关键信息,便于调用方及时更新订单状态、推进后续业务流程。 该通知一般在用户完成收银台支付后由平台自动发起,调用方需确保 notify_url 可稳定接收并正确处理通知请求。
由平台发起调用 请求参数
- 请求方式
POST
- Headers
Content-Type: application/x-www-form-urlencoded
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
app_id | 平台分配给开发者的应用 Id | String | 是 |
method | 平台通知的方法名 | String | 是 |
timestamp | 时间格式 (yyyy-MM-dd HH:mm:ss) | String | 是 |
sign_type | 签名算法类型,目前支持 RSA | String | 是 |
sign | 签名 | String | 是 |
biz_content | 通知的业务参数 | Json | 是 |
biz_content
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
trade_no | 平台交易凭证号 | String | 是 |
out_trade_no | 原支付请求的商户订单号 | String | 是 |
user_id | 买家平台账号对应的平台唯一用户号 | String | 否 |
trade_status | 交易目前所处的状态,见交易状态说明 | String | 否 |
total_amount | 本次交易支付的订单金额,单位为人民币(元) | Number(9,2) | 否 |
gmt_payment | 该笔交易的买家付款时间,格式为 yyyy-MM-dd HH:mm:ss | String | 否 |
industry_sepc_detail | 医保平台返回内容(用户使用医保支付时必传) | Json | 否 |
industry_sepc_detail
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
bill_no | 医保业务单据号 | String | 是 |
inner_amount | 现金支付金额 | String(9,2) | 是 |
ssc_amount | 社保支付金额 | String(9,2) | 是 |
medical_serial_no | 医保就诊记录号 | String | 是 |
response_content | 医保透传结果(以各地区人社文档为主) | String | 是 |
接收方返回参数
直接返回 success 即可。
接口示例
参数示例
以下是JSON:
json
biz_content={"out_trade_no":"wxg1zy0520250626004247200783","trade_no":"4200002754202506264599062813","user_id":"oYSo9xHltK93iOeeVct4p-qwcSnk","total_amount":"498.00","trade_status":"TRADE_SUCCESS","gmt_payment":"2025-06-26 00:43:55","payment_type":"weixin","response_content":"<xml><sub_is_subscribe><![CDATA[N]]></sub_is_subscribe><trade_type><![CDATA[JSAPI]]></trade_type><time_end><![CDATA[20250626004355]]></time_end><appid><![CDATA[wx2b2e8197d361652d]]></appid><sub_mch_id><![CDATA[1502012801]]></sub_mch_id><sub_appid><![CDATA[wxbecb25c0cf97cfd1]]></sub_appid><out_trade_no><![CDATA[wxg1zy0520250626004247200783]]></out_trade_no><result_code><![CDATA[SUCCESS]]></result_code><bank_type><![CDATA[OTHERS]]></bank_type><nonce_str><![CDATA[f4f10a83d1924d3d96c83df821cbee20]]></nonce_str><sub_openid><![CDATA[oTCMQ0op1VEBAKTSV18CtWv3B3g4]]></sub_openid><cash_fee><![CDATA[49800]]></cash_fee><transaction_id><![CDATA[4200002754202506264599062813]]></transaction_id><is_subscribe><![CDATA[N]]></is_subscribe><mch_id><![CDATA[1499772492]]></mch_id><fee_type><![CDATA[CNY]]></fee_type><openid><![CDATA[oYSo9xHltK93iOeeVct4p-qwcSnk]]></openid><sign><![CDATA[92598C629638095BB914C81D47AEC4F7]]></sign><return_code><![CDATA[SUCCESS]]></return_code><total_fee><![CDATA[49800]]></total_fee></xml>"}
method=lc.trade.notify
nonce_str=0c35f912-5a9e-43b6-8b7f-926fdb0f51e0
sign=MXGfaemi5QfDHWZSb7ptLDDcARSFM34XZnsXH%2b1MR5vrmBR%2baWJOe9ChVe5uNBB5%2ff%2bULupH%2fbhO%2fndZGQTB%2bxK8Z1Xr2yZ0JuEB7BD7yITSHjojHPTI94xrt87AZNb3YzifC%2fF35fkoMZGAuDC3v%2f%2fUProA679mosGIOr1LQJ0%3d
sign_type=rsa
timestamp=2025-06-26 00:43:56
json
success
trade_status常见状态码
错误码 | 描述 |
---|---|
WAIT_BUYER_PAY | 交易创建,等待买家付款 |
TRADE_CLOSED | 未付款交易超时关闭,或支付完成后全额退款 |
TRADE_SUCCESS | 交易支付成功 |
TRADE_FINISHED | 交易结束,不可退款 |