《天工收银开放接口文档V0722-网站在线支付》由会员分享，可在线阅读，更多相关《天工收银开放接口文档V0722-网站在线支付（11页珍藏版）》请在金锄头文库上搜索。
1、 商派天工网站收银接口文档 V0722 2016 年 7 月 22 日 版本控制 版本 日期 人员 描述 V0712 2016 年 7 月 12日 Teegon 创建文档 V0718 2016 年 7 月 18日 Teegon 接口支付渠道增加银联 B2C 网银支付 unionpay V0722 2016 年 7 月 22日 Teegon 接口支付渠道将银联 B2C 网银支付接口参数改成 chinapay_b2c 新增银联快捷支付 参数 chinapay 网站收银网站收银 网站收银主要用于 PC 交易网站上，通过网页跳转的方式实现商家收银的功能，消费者可以选择支付渠道包括支持微信支付、支付宝、
2、银联电子支付。 网站收银涉及接口如下 网站收银接口（/charge/pay），点此下载 DEMO 接入准备接入准备 获取开发参数获取开发参数 天工收银通过开发参数 client_id & client_secret 来标记及验证商户身份，开发参数可以在天工收银后台获取。 登陆天工收银，点击开发配置，获取开发参数 client_id & client_secret 快速接入快速接入 您可以下载 DEMO，通过配置，快速测试收银接口的接入。 DEMO 下载地址： https:/ 场景描述场景描述 1、 消费者在商家网站选购商品商品 2、 选择天工收银作为支付渠道 3、 提交支付请求到天工，天工处理
3、支付请求 4、 消费者扫码或者输入第三方支付账号密码完成支付 5、 浏览器跳回商家交易网站，并带有支付结果参数 6、 天工收银通过服务器通知方式告知支付结果 7、 商家网站处理支付信息 天工收银的网站收银接口使用，可参考如下时序图。 消费者商家天工第三方下单并提交支付请求1、响应请求，并生成支付参数2、发起支付请求处理支付请求跳转至第三方处理支付请求返回支付消息3、同步跳转并通知 return6、处理信息更新支付状态5、异步服务器通知 notify4、处理信息 消费者请求支付，商家通过生成参数，向天工收银网关地址发起页面跳转请求，支付处理完成后，页面跳回，商家处理回调参数，同时天工收银服务器向
4、商家服务器发起通知，商家处理通知信息。 接口列表接口列表 网站收银接口网站收银接口 本接口用于 PC 交易网站向天工收银发起支付请求，请求方式为页面跳转，消费者完成支付流程后，天工会通过页面跳转及服务器通知的方式将支付结果提交给商家系统，商家系统根据这些返回数据进行交易状态的判断和处理，完成整个支付流程。 请求参数请求参数 请求参数是商家在与天工收银进行数据交互时，提供给天工收银的请求数据，以便天工收银根据这些数据进行进一步处理。 参数参数 参数名参数名 类型类型 必填必填 描述描述 示例示例 公共参数公共参数 client_idclient_id 用户身份 ID String(24) 是 天
5、工收银分配给商家的身份标识 Naff12qqsnqlm24ps5cue12a notify_urlnotify_url 接口异步通知地址 String（256） 否 天工收银服务器主动将支付结果通知到商家服务器里指定页面的地址 https:/ return_urlreturn_url 页面跳转同步通知页面地址 String(256) 是 支付请求处理完请求后，当前页面自动跳转到商家网站里指定页面地址 https:/ signsign 签名 String(32) 是 商户请求的签名，算法见附录：签名与验签 FF9F93DBC711715CDBD35C91D1D7809B 业务参数业务参数 ord
6、er_noorder_no 订单编号 String(64) 是 商户自编订单 ID 20160101124567878 channelchannel 支付渠道 String(10) 是 天工收银提供的支付渠道 wxpay：微信扫码支付 alipay：支付宝即时交易 chinapay：银联快捷支付 chinapay_b2c ： 银 联B2C 网银支付 wxpay amountamount 订单金额 Number 是 订单金额 23.45 subjectsubject 商品信息 String(128) 是 订单中商品信息 高级钱包 metadatametadata 附加信息 String(512)
7、 否 额外数据(json 格式，会在支付成功后回调接口传回) client_ipclient_ip 客户端 ip String(20) 否 客户端 ip 192.168.1.1.1 接口调用说明接口调用说明 内容内容 规则规则 网关地址网关地址 https:/ 传输方式传输方式 为保证安全，采用 hppts 传输方式 签名方式签名方式 MD5 方式，签名字段名 sign 提交方式提交方式 POST 方式 数据格式数据格式 返回数据采用 JSON 格式 字符编码字符编码 UTF8 提交内容示例： 本示例仅供参考 注意事项注意事项 1、 本接口只支持 https 请求 2、 请按照本文档“附录：签
8、名与验签”中的签名方法对输入参数进行签名，该接口请求才能够被天工收银系统接收； 3、 发起请求后返回参数采用 JSON 格式，天工收银有成功与失败两种情况 成功返回示例成功返回示例 支付成功后，将跳到相应支付页面 失败返回示例失败返回示例 “error“: “错误信息”, “result”:”, 页面同步跳转页面同步跳转 天工收银对商家的请求处理完后，会将该处理结果通过页面自动跳转的方式通知商户网站，这些结果以参数的形式发送，参数发送方法为 GETGET。 参数参数 参数名参数名 描述描述 示例示例 a amountmount 订单金额 订单金额 12.34 b bankank 对应银行 支付
9、方式对应的银行名称 交通银行 可为空 b buyeruyer 买家 根据不同的支付渠道，返回不同的买家信息，微信支付为相关 id，支付宝支付为手机号码或者邮件地址 channelchannel 支付渠道 天工收银提供的支付渠道 wxpay：微信扫码支付 alipay：支付宝即时交易 wxpay c chargeharge_id_id 支付单号 天工收银系统内的支付单号 87diui7y8e687gf d device_evice_infoinfo 设备号 预留用于智能设备记录 is_successis_success 是否成功 支付是否成功，ture/false ture metadatam
10、etadata 附加信息 额外数据(json 格式，会在支付成功后回调接口传回) 如果用户请求时传递了该参数，则返回给商户时会回传该参数。 order_noorder_no 订单编号 商户自编订单 ID 20160101124567878 pay_timepay_time 支付时间 以时间戳方式记录的支付时间 1466057771 real_amounreal_amount t 真实金额 为扣除天工手续费后的实际入账金额 12.11 statusstatus 调用状态 调用说明 trade_status_sync timestamptimestamp 系统时间戳 天工收银服务器发起请求的时间
11、1466057771 signsign 签名 用于验证通知参数的签名，算法见附录：签名与验签 FF9F93DBC711715CDBD35C91D1D7809B 返回内容示例： https:/ 本示例仅供参考 注意事项注意事项 1、根据商家在提交支付参数中设定的 return_url 参数进行跳转 2、请按照本文档“附录：签名与验签”中的签名方法对返回参数进行签名并比对返回的签名判断数据是否由天工收银返回，确保业务安全。 服务器异步通知服务器异步通知 天工收银对商家的请求处理完后，会将该处理结果通过服务器主动通知的方式通知商户网站，这些结果以参数的形式发送，参数发送方法为 POSTPOST。 参数参数 参数名参数名 描述描述 示例示例 a amountmount 订单金额 订单金额 12.34 b bankank 对应银行 支付方式对应的银行名称 交通银行 可为空 b buyeruyer 买家
