| 参数名 | 格式 | 必填 | 含义 | 备注 |
|---|---|---|---|---|
| version | Int | Y | 版本号 | 1 |
| app_id | String(32) | Y | 应用ID | 汇收银分配的应用ID |
| mch_id | Int | Y | 商户ID | 汇收银商户ID |
| charset | String | Y | 编码格式 | 商户网站使用的编码格式,如utf-8、gbk、gb2312等 |
| out_trade_no | String(64) | Y | 商户订单号 | 商户网站唯一订单号 |
| timestamp | String | N | 签名时间戳 | 时间戳,毫秒数,如:1435890533866 |
| sign_type | String | Y | 签名方式 | DSA、RSA、MD5三个值可选,必须大写 |
| sign | String | Y | 签名 |
| 参数名 | 格式 | 必填 | 含义 | 备注 |
|---|---|---|---|---|
| return_code | String(16) | Y | 返回状态码 | SUCCESS/FAIL |
| err_code | String(32) | N | 错误代码 | E0000、E0001 |
| err_code_des | String(128) | N | 错误代码描述 | 参数错误等 |
| 参数名 | 格式 | 必填 | 含义 | 备注 |
|---|---|---|---|---|
| app_id | String(32) | Y | 应用ID | 汇收银分配的应用ID |
| mch_id | Int | Y | 商户ID | 汇收银商户ID |
| version | Int | Y | 版本号 | 1 |
| charset | String | Y | 编码格式 | 商户网站使用的编码格式,如utf-8、gbk、gb2312等 |
| sign_type | String | Y | 签名方式 | DSA、RSA、MD5三个值可选,必须大写 |
| sign | String | Y | 签名 |
| 参数名 | 格式 | 必填 | 含义 | 备注 |
|---|---|---|---|---|
| out_trade_no | String(64) | Y | 商户订单号 | 商户网站唯一订单号 |
| hy_bill_no | String(32) | N | 汇收银交易号 | |
| channel_provider | String(16) | Y | 渠道类型 | 类型,如:微信、支付宝、百度、银联等 |
| channel_code | String(16) | Y | 渠道编码 | 根据渠道类型,指定编码,如:渠道类型是银联,渠道编码指定是建行。渠道类型是微信,渠道编码指定是APP |
| subject | String(256) | Y | 标题 | |
| currency | String(3) | Y | 货币类型 | 默认人民币:CNY |
| pay_fen_amt | Int | Y | 交易金额 | 支付金额,必须是正整数,单位为分 |
| bill_timeout | Int | Y | 商户订单超时时间 | 单位分,默认6分钟 |
| trade_status | String | Y | 交易状态 | SUCCESS—支付成功 REFUND—转入退款 NOTPAY—未支付 CLOSED—已关闭 REVOKED—已撤销 USERPAYING—用户支付中 PAYERROR—支付失败(其它原因,如银行返回失败) |
| hy_deal_time | String(14) | Y | 支付完成时间 | yyyyMMddHHmmss |
| merch_extra | String(255) | N | 商户扩展信息 | 商户自定义的参数,将会在通知中原样返回 |
| hy_pay_extra | String(255) | N | 汇元支付结果扩展信息 | 汇元支付结果扩展信息 |