概要描述:
该接口提供所有码交易支付订单的查询,商户可以通过该接口主动查询订单状态,完成下一步的业务逻辑。
请求URL:
请求参数(O-非必传 ,M-必传,C-选传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
merch_no | 海科商户编号 | String(32) | 海科商户编号 | M | |
out_trade_no | 服务商支付订单号 | String(32) | trade_no、out_trade_no二选一上送,优选顺序:trade_no、out_trade_no | C | |
trade_no | 海科支付订单号 | String(32) | trade_no、out_trade_no二选一上送,优选顺序:trade_no、out_trade_no | C |
请求示例:
{
"agent_no": "IS88888888",
"req_id": "147258369",
"merch_no": "83388888888",
"out_trade_no": "123456789",
"sign": "5F154E14FDC459ED5DF628B56F61A609"
}
返回参数(O-非必传 ,M-必传,C-选传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
result_code | 响应码 | String | 10000代表业务处理成功,交易结果需要根据trade_status判断 | M | |
result_msg | 响应信息 | String | M | ||
error_code | 错误码 | String | trade_status=2时返回 | O | |
error_msg | 错误信息 | String | trade_status=2时返回 | O | |
agent_no | 服务商编号 | String | M | ||
merch_no | 海科商户编号 | String | 海科商户编号 | M | |
total_amount | 交易金额 | String(12) | 上送银联的交易金额(单位:元,支持2位小数) | M | |
order_amount | 订单金额 | String | 订单总金额(单位:元,支持2位小数) | M | |
discount_amount | 免充值优惠券金额 | String | 不走结算资金的免充值型优惠券金额(单位:元,支持2位小数) | O | |
pay_type | 支付类型 | String | WX:微信支付 ALI:支付宝支付 UNIONQR:云闪付 |
M | |
pay_mode | 支付方式 | String | NATIVE:扫码支付 JSAPI:JSAPI支付 BARPAY:付款码支付 |
M | |
out_trade_no | 服务商支付订单号 | String | M | ||
trade_no | 海科支付订单号 | String | M | ||
pn | SAAS终端号 | String(32) | SAAS终端号 | M | |
trade_status | 交易状态 | String | 1:交易成功 2:交易失败 3:交易进行中 |
M | |
clear_status | 清算状态 | String | 1:已清算 2:未清算 |
M | |
real_fee_amount | 实收手续费金额 | String | 实收手续费金额(单位:元,支持2位小数) clear_status=1时返回 |
C | |
fee_subsidy_amount | 手续费补贴金额 | String | 手续费补贴金额(单位:元,支持2位小数) 有手续费补贴且clear_status=1时返回 |
C | |
market_subsidy_amount | 营销补贴金额 | String | 营销补贴金额(单位:元,支持2位小数) 有营销补贴且clear_status=1时返回 |
C | |
settle_amount | 交易结算金额 | String | 交易结算金额(单位:元,支持2位小数) clear_status=1时返回 |
C | |
trade_rate | 交易费率 | String | 交易费率,单位:% clear_status=1时返回 |
0.38 | C |
settle_way | 交易结算方式 | String | 交易结算方式 clear_status=1时返回 |
C | |
appid | 公众账号ID | String | 微信支付时使用的公众账号 ID | O | |
openid | 用户标识 | String | 用户标识 | O | |
sub_mch_id | 报备商户编号 | String | 通道子商户号(ATU商户号) | O | |
end_time | 交易完成时间 | String | 交易在海科的完成时间 | 2024-01-01 10:10:10 | O |
bank_trade_no | 银联订单号 | String | 银联订单号 | O | |
card_type | 卡类型 | String(10) | 01:借记卡 02:贷记卡 |
O | |
remark | 备注 | String(100) | 交易备注,原交易请求时上送的备注信息 | O | |
attach | 通道原生参数 | String | O |
返回示例:
{
"discount_amount": "0.00",
"sign": "2BB9386345E71D80363CDDFD542C6001",
"agent_no": "FW3002100",
"return_msg": "成功",
"result_msg": "请求成功",
"pay_mode": "BARPAY",
"out_trade_no": "640000200704218151",
"total_amount": "1.01",
"settle_amount": "0.71",
"order_amount": "1.01",
"clear_status": "1",
"settle_way": "D1",
"real_fee_amount": "0.30",
"fee_subsidy_amount": "0.20",
"market_subsidy_amount": "3",
"trade_rate": "0.38",
"trade_status": "1",
"pn": "A00000001",
"trade_no": "WX240411110602000615748248",
"bank_trade_no": "4200002157202404112867871702",
"sub_mch_id": "626185853",
"end_time": "2024-04-11 11:06:04",
"pay_type": "WX",
"result_code": "10000",
"attach": "{
\"transaction_id\": \"4200002157202404112867871702\",
\"nonce_str\": \"ee4cd0486b434934b61b3fd4e088b2c5\",
\"trade_state\": \"SUCCESS\",
\"bank_type\": \"COMM_CREDIT\",
\"openid\": \"sdfgSjkOdekjshjMHp7efaeBmjU\",
\"cert_id\": \"4233741533\",
\"return_msg\": \"成功\",
\"fee_type\": \"CNY\",
\"mch_id\": \"1505378701\",
\"sub_mch_id\": \"626185853\",
\"cash_fee\": \"101\",
\"out_trade_no\": \"WX240411110602000615748248\",
\"cash_fee_type\": \"CNY\",
\"coupon_fee\": \"0\",
\"appid\": \"wx17728c1a8fa300d6\",
\"total_fee\": \"101\",
\"settlement_total_fee\": \"101\",
\"trade_type\": \"MICROPAY\",
\"result_code\": \"SUCCESS\",
\"time_end\": \"20240411110604\",
\"sign_type\": \"SM2\",
\"return_code\": \"SUCCESS\"
}",
"return_code": "SUCCESS"
}
文档更新时间: 2025-03-12 17:30 作者:陈文