文档

测试

退款&查询

websocket测试

POST

https://weixin.hntonglink.com/tradePay/api/serve

请求参数

application/x-www-form-urlencoded

参数名

类型

描述

必填

proid

String

应用id，平台唯一

必填

trxamt

String

金额，单位分， servetype为refund必填

可选

refundreqsn

String

退款订单号 , servetype为refund必填

必填

servetype

String

业务方式, refund/query 退款/查询

必填

cusid

String

支付号，交易完成时返回

必填

reqsn

String

原订单号，商户唯一

必填

signtype

String

签名类型，支持RSA/MD5

必填

sign

String

签名

必填

退款响应参数

application/json

参数名

取值

可空

msg

信息说明

否

retcode

返回码 SUCCESS/FAIL

否

retmsg

返回码说明

是

以下信息只有当retcode为SUCCESS时有返回

以下信息只有当retcode为SUCCESS时有返回

以下信息只有当retcode为SUCCESS时有返回

cusid

支付号

否

appid

平台分配的APPID

否

trxid

收银宝平台的退款交易流水号

否

reqsn

商户的退款交易订单号

否

trxstatus

交易的状态

否

fintime

交易完成时间 yyyyMMddHHmmss

是

errmsg

失败的原因说明

是

fee

手续费

是

trxcode

交易类型

是

randomstr

随机生成的字符串

否

chnltrxid

渠道流水号如支付宝，微信平台订单号

是

chnldata

渠道信息

是

sign

签名

否

code

响应码 200/502 正确/错误

否

查询响应参数

application/json

参数名

取值

可空

msg

信息说明

否

retcode

返回码

否

retmsg

返回码说明

是

以下信息只有当retcode为SUCCESS时有返回

以下信息只有当retcode为SUCCESS时有返回

以下信息只有当retcode为SUCCESS时有返回

cusid

支付号

否

appid

平台分配的appid

否

trxid

平台的交易流水号

否

chnltrxid

支付渠道交易单号

是

reqsn

商户的交易订单号

否

trxcode

交易类型

否

trxamt

单位为分

否

trxstatus

见交易返回码说明如果trxstatus为空,则交易正在处理中,尚未完成

是

acct

微信支付-用户的微信openid 支付宝支付-用户user_id

是

fintime

交易完成时间yyyyMMddHHmmss

是

randomstr

随机字符串

否

errmsg

失败的原因说明

是

cmid

渠道子商户号限微信/支付宝交易响应

是

chnlid

渠道号限微信交易响应

是

initamt

原交易金额与请求字段trxamt值一致

是

fee

手续费单位：分

是

chnldata

渠道信息目前返回云闪付/微信/支付宝的活动参数

否

accttype

借贷标识 00-借记卡 02-信用卡 99-其他（花呗/余额等）

是

sign

否

code

响应码 200/502 正确/错误

说明 / 示例

查询成功案例 ```json { "msg": { "randomstr": "380520908189", "trxcode": "VSP511", "fee": "0", "sign": "PV/BU+cYegV8gYIDnfAcnIOUkyxsUibgUEozRoJKwAULFCk3rmzrHJ09Sc0DL1TyFCxEt0LM2eVzO0M4gGGK4rzX2Yv6pbB5bGI7hO7ObTSCVESl/8GcbKj8u5VC7gPVrJG8wyI3dxA2XEJIcU5/9VfKUUwJvkG+Jo7qvyHfmSM=", "cmid": "2088900598356582", "trxid": "230713127353338130", "trxstatus": "0000", "accttype": "02", "reqsn": "8627465574", "chnltrxid": "2023071322001496111413655674", "fintime": "20230713155306", "cusid": "560551048166VU9", "appid": "00185724", "initamt": "1", "acct": "2088722626596113", "trxamt": "1", "chnldata": "{\"fund_bill_list\":\"[{\\\"amount\\\":\\\"0.01\\\",\\\"fundChannel\\\":\\\"BANKCARD\\\",\\\"fundType\\\":\\\"CREDIT_CARD\\\"}]\"}", "retcode": "SUCCESS" }, "code": 200 } ``` 退款成功案例 ```json { "msg": { "randomstr": "135320453770", "trxcode": "VSP513", "fee": "0", "sign": "lVqh9jSHnuo2nxskF7ODXI2fxVShR/jAsw56G8cPM8Z5tER31C5oW6JWZy/rNdtaN/laaF+qtY9HdEwKGksN4MbxzVxUnXikemPdyk5zZRSTcq6v4mQR1Dqgtnim3ZnH70KCqSV+aOnLA93xqoLQtg+9QouyzLkia5XxAHPasAg=", "trxid": "230713122153330694", "trxstatus": "0000", "reqsn": "11111111", "chnltrxid": "2023071322001496111413655674", "fintime": "20230713164455", "cusid": "560551048166VU9", "appid": "00185724", "chnldata": "{\"refund_detail_item_list\":\"[{\\\"amount\\\":\\\"0.01\\\",\\\"fund_channel\\\":\\\"ALIPAYACCOUNT\\\"}]\"}", "retcode": "SUCCESS" }, "code": 200 } ```

上一篇统一下单

nextDoc 交易返回码trxstatus说明