API开发文档简介
本文阅读对象:使用 信恒支付 商户自服务系统的技术架构师、研发工程师、系统运维工程师。通过本文档,商户可了解 信恒支付 接入的技术、接入的产品业务、接入的流程、接入规范等信息,以便于商户顺利完成接入工作。
接入网关
请登录商户中心,API管理 开发文档中 查看网关地址和API对接参数。
统一下单接口
提交方式:POST
地址: 接入网关/Pay/Index.html
| 参数名称 |
参数含义 |
是否必填 |
参与签名 | 参数说明 |
| pay_memberid |
商户号 |
是 |
是 |
平台分配商户号 |
| pay_orderid |
订单号 |
是 |
是 |
上送订单号唯一, 字符长度20 |
| pay_applydate |
提交时间 |
是 |
是 |
时间格式:2016-12-26 18:18:18 |
| pay_bankcode |
银行编码 |
是 |
是 |
在商户中心查询 |
| pay_notifyurl |
服务端通知 |
是 |
是 |
服务端返回地址.(POST返回数据) |
| pay_callbackurl |
页面跳转通知 |
是 |
是 |
页面跳转返回地址(POST返回数据) |
| pay_amount |
订单金额 |
是 |
是 |
单位:元 |
| pay_md5sign |
MD5签名 |
是 |
是 |
请查看签名算法 |
| pay_productname |
商品名称 |
是 |
否 |
|
| pay_productnum |
商户品数量 |
否 |
否 |
|
| pay_productdesc |
商品描述 |
否 |
否 |
|
| pay_producturl |
商户链接地址 |
否 |
否 |
|
异步通知
提交方式:POST
接收到服务器点对点通讯时,在页面输出“OK”( 没有双引号,OK 两个字母大写 ) ,否则会重复5次发送点对点通知.
| 参数名称 |
参数含义 |
是否必填 |
参与签名 | 参数说明 |
| memberid |
商户编号 |
是 |
是 |
平台分配商户号 |
| orderid |
订单号 |
是 |
是 |
上送订单号唯一, 字符长度20 |
| amount |
订单金额 |
是 |
是 |
|
| transaction_id |
交易流水号 |
是 |
是 |
|
| datetime |
交易时间 |
是 |
是 |
|
| returncode |
交易状态 |
是 |
是 |
00表示成功,其它表示失败 |
| attach |
扩展返回 |
否 |
是 |
商户附加数据返回 |
| sign |
MD5签名 |
是 |
否 |
|
订单查询接口
提交方式:POST
地址: 接入网关/Pay/Trade/query.html
| 参数名称 |
参数含义 |
是否必填 |
参与签名 | 参数说明 |
| pay_memberid |
商户编号 |
是 |
是 |
|
| pay_orderid |
商户订单号 |
是 |
是 |
|
| pay_md5sign |
MD5签名 |
是 |
是 |
|
返回值
| 参数名称 |
参数含义 |
是否必填 |
参与签名 | 参数说明 |
| memberid |
商户编号 |
是 |
是 |
|
| returncode |
请求状态 |
是 |
是 |
00表示成功,其它表示失败 |
| data |
订单信息(数据类型:集合) |
是 |
否 |
|
| sign |
MD5签名 |
是 |
否 |
|
返回值data参数
| 参数名称 |
参数含义 |
参数说明 |
| orderid |
商户订单号 |
|
| transaction_id |
平台订单号 |
|
| amount |
订单金额 |
单位:元 |
| time_end |
支付成功时间 |
|
| trade_state |
支付状态 |
SUCCESS:支付成功,NOTPAY:未支付 |
渠道编码
请登录商户中心,API管理 通道费率中 查看所属应用的支付通道编码。