支付请求接口

买家在商户网站拍下商品后,选择汇潮支付付款,商户系统调用汇潮支付支付接口,页面跳转到汇潮支付支付中心。用户完成支付后,汇潮支付把用户引导回商户页面(ReturnURL),同时服务器后台通知商户服务器(AdviceURL)支付结果。

请求地址

环境 HTTPS请求地址
正式环境 https://gwapi.yemadai.com/pay/sslpayment

请求参数

参数 参数名称 类型(长度) 参数说明 是否为空 样例
MerNo 商户号 String(20) 商户号,注册所得 必须 10000
BillNo 订单号 String 网站的购物订单号 必须 N19245025450245
Amount 金额 String(190) 该笔订单的资金总额,单位为:RMB。取值范围[1,1000000.00]精确到小数点后两位。 必须 12.21
ReturnURL 页面跳转同步通知页面 String(200) 支付完成后web页面跳转显示支付结果 必须 https://pay.ecpss.com /ReturnURL.htm
AdviceURL 服务器异步通知路径 String(190) 汇潮服务器主动异步通知商户网站指定的路径 必须 https://pay.ecpss.com/ AdviceURL.htm
SignInfo 签名信息 String() 支付请求签名 必须
OrderTime 请求时间 Date 交易时间,格式:YYYYMMDDHHMMSS 必须 19880101215415
defaultBankNumber 银行编码 String(7) 银行代码(见银行编码表),可为空传递对应编码表中的值,直接跳转到对应的银行网银界面 可选 ICBC
payType 支付方式 String(10) 支付方式,联系业务员开通 可选 可传入参数:
B2CCredit:B2C信用卡
B2CDebit: B2C借记卡
noCard: 银联快捷支付
quickPay: 快捷支付
B2B:企业网银支付
Remark 备注 String(7) 备注 可选 100
products 物品信息 String(170) 物品信息 可选 汇潮支付充值

返回参数

参数 参数名称 类型(长度) 参数说明 是否为空 样例
MerNo 订单号 String(32) 一麻袋数字账户 必须 10000
BillNo 订单号 String(32) 您的网站订单号 必须 10000001
OrderNo 支付订单号 String(32) 一麻袋支付订单号 必须 1000000002
Amount 金额/td> Number 该笔订单的资金总额,单位为RMB-Yuan。取值范围为[1,1000000.00]。 必须 12.21
Succeed 状态码 String(20) 状态码88: 成功其他为失败 必须 88
Result 订单详情 String 订单详细信息 可选 SUCCESS
SignInfo 验证签名 String(32) 支付结果返回 非空

银行编码表

银行 编码
1 工商银行 ICBC
2 农业银行 ABC
3 中国银行 BOCSH
4 建设银行 CCB
5 招商银行 CMB
6 浦发银行 SPDB
7 广发银行 GDB
8 交通银行 BOCOM
9 邮政储蓄银行 PSBC
10 中信银行 CNCB
11 民生银行 CMBC
12 光大银行 CEB
13 华夏银行 HXB
14 兴业银行 CIB
15 上海银行 BOS
16 上海农商 SRCB
17 平安银行 PAB
18 北京银行 BCCB
19 中行(大额) BOC
20 银联无卡支付 NOCARD
21 银联其他银行 OTHERS

部分错误码说明

代码 描述
11003 金额格式不正确
11004 请不要打开多个支付页面或者页面超时
11005 支付方式错误或者卡类型错误
11006 支付密码有误
11007 内部系统之间签名错误
1001 订单已存在
1002 订单状态有误
1003 支付方式未开通
1004 订单超时
1005 银行签名失败
1006 不存在的交易类型