统一下单

1、接口地址：https://api.heemoney.com/rest/v1/pay

2、请求方式：POST

3、参数格式：JSON\Map

4、请求参数

参数名 格式 必填 含义 备注
version Int Y 版本号 1
app_id String(32) Y 应用ID 汇收银分配的应用ID
mch_id Int Y 商户ID 汇收银商户ID
charset String Y 编码格式 商户网站使用的编码格式，如utf-8、gbk、gb2312等
timestamp String Y 签名时间戳 时间戳，毫秒数,如：1435890533866
sign_type String Y 签名方式 DSA、RSA、MD5三个值可选，必须大写
channel_provider String(16) Y 渠道类型 类型，如：微信、支付宝、百度、银联等。见渠道类型
channel_code String(16) Y 渠道编码 根据渠道类型，指定编码，见渠道编码。如：渠道类型是银联，渠道编码指定是建行。渠道类型是微信，渠道编码指定是APP。
out_trade_no String(64) Y 商户订单号 商户网站唯一订单号
currency String(3) Y 货币类型 默认人民币：CNY
total_amt_fen Int Y 交易金额 总金额按分，必须是正整数，单位为分
bill_timeout Int Y 商户订单超时时间 单位分，默认6分钟
subject String(256) Y 商品标题 商品标题/交易标题/订单标题/订单关键字等
subject_detail String(1000) N 商品详情
user_identity String(50) N 商户用户唯一标识 用户在商户平台的唯一标识
user_ip String(16) Y 商户用户IP 终端IP，用户IP
merch_extra String(255) N 商户扩展信息 商户自定义的参数，将会在通知中原样返回
meta_option String(255) N 商户定制信息 商户自制样式参数，见商户定制信息。格式：{"key1":"value1","key2":"value2"......}
pay_option String(255) N 支付参数信息 支付扩展参数，见支付参数信息。格式：{"key1":"value1","key2":"value2"......}
notify_url String(200) N 通知地址 服务器异步通知页面路径
return_url String(200) N 商户前台通知URL 支付渠道处理完请求后，当前页面自动跳转到商户网站里指定页面的http路径
sign String Y 签名

5、返回结果

参数名 格式 必填 含义 备注
return_code String(16) Y 返回状态码 SUCCESS/FAIL
err_code String(32) N 错误代码 E0000、E0001
err_code_des String(128) N 错误代码描述 参数错误等

 以下字段在return_code为SUCCESS

参数名 格式 必填 含义 备注
version Int Y 版本号 1
app_id String(32) Y 应用ID 汇收银分配的应用ID
mch_id Int Y 商户ID 汇收银商户ID
charset String Y 编码格式 商户网站使用的编码格式，如utf-8、gbk、gb2312等
sign_type String Y 签名方式 DSA、RSA、MD5三个值可选，必须大写
sign String Y 签名

 以下字段在return_code为SUCCESS，err_code为E0000时返回

参数名 格式 必填 含义 备注
out_trade_no String(64) Y 商户订单号 商户网站唯一订单号
hy_bill_no String(32) N 汇收银交易号
trade_status String Y 交易状态 SUCCESS—支付成功
REFUND—转入退款
NOTPAY—未支付
CLOSED—已关闭
REVOKED—已撤销
USERPAYING—用户支付中
PAYERROR—支付失败(其它原因，如银行返回失败)
merch_extra String(255) N 商户扩展信息 商户自定义的参数
hy_pay_extra String(255) N 汇元支付结果扩展信息 汇元支付完成后参数信息