收付平台接口方案V1.3.doc

收付平台接口方案收付平台接口方案 1接口说明 1商户提交待付款订单接口 1页面跳转同步通知 5服务器异步通知 6接收首信易转帐结果通知接口 7支付宝入账定时任务 7接收发票信息接口 8退款接口 8退款通知接口 8按到款记录查询接口（收付平台也提供此界面） 8按到款明细查询接口（收付平台也提供此界面） 8确认收款接口（收付平台也提供此界面） 8签名机制 8数据库设计 9合作方信息表 9支付项目表 9支付项目类型表 10收入分配表 10发票信息表 10到款记录表 10支付流水表 11异步消息表 12系统日志表 12基础界面F0界面-订单付款前界面业务系统订单选购界面；或者是业务系统订单维护界面如上点击“付款”按钮，组织参数，跳转到收费平台的订单提交付款接口Url-FK中F1界面-订单付款选择界面收付平台的订单付款选择界面，此界面可以看到银行选择列表（可能包括支付宝或者易付款选择），应该是收付平台自己定义的界面F2界面-订单付款结果界面订单收款成功界面 或者 订单收款失败界面或者订单验证不通过界面等都是用来显示结果信息的URl-FK收付平台的订单提交付款接口，有自己的一些列参数如果参数中需要增加时间验证信息，应该调用收付平台的其它接口，获取收付平台的时间作为参数。

调用流程第一步l F0界面上选择“付款“按钮，按照给定的接口，组织订单参数，调用接口 URL-FK.第二步l URL-FK.接口开始解析参数，通过Sign签名验证参数的完整性l 通过参数中的订单编号信息和其它信息，在收付平台数据库中检索订单信息并验证订单付款情况结果：付款成功：组织参数，调用并展示 F2 界面，提示订单已付款，然后结束付款失败：组织参数，调用并展示 F2 界面，提示订单付款失败及原因 （这个以后还允许重新付款吗？），然后结束付款中：组织参数,调用F1界面.提示选择付款的银行等信息无订单记录：插入一条订单记录，其状态为“付款中”，然后组织参数，调用 F1界面第三步l 在F1界面中选择银行信息（或者支付宝账户），点击“下一步”l 重新验证当前订单信息，分别处理付款成功/付款失败：分别处理并调用F2界面，结束无订单记录：应该是付款系统有异常，提示管理员查找Bug等付款中：从数据库中获取信息，组织参数（包括F1界面选择的银行信息等），调用支付宝订单付款接口l 后续付款环节：调用支付宝订单付款接口后，全部由支付宝接口处理后续逻辑，包括显示银行账号密码输入部分和提交，或者自动处理防止订单多次提交的逻辑等。

第四步l 支付宝付款完成后，组织参数，调用收付平台传递给支付宝的Url-12，返回订单支付结果信息l Url-12解析并验证参数信息，如果付款成功，使用事务，把保存返回参数信息并更新订单状态为“付款成功”如果失败，同样保存并更新l Url-12完成更新后，调用URL-FK接口传递过来的返回Url（命名为Url-2，应该继教学院写的）,组织本地数据，一起返回给调用收付平台的客户端（继教学院）第五步l 参考支付宝的异步通知逻辑，同样完成一套收付平台的异步通知功能接口说明商户提交待付款订单接口流程：1. 根据合作方编号查找对应的密钥，用此密钥验证签名是否正确2. 在支付流水表中插入一条记录3. 根据支付项目的配置，调用支付宝或首信易支付的接口提供给合作方业务系统接口的参数：参数中文名称类型（字节长度） 参数说明 是否可为空t_partner 合作方编号 String(4)t_out_trade_no商户网站唯一订单号String(32)合作方业务系统唯一订单号t_item支付项目编号String（6）t_subitem子项目编号String（6）t_user_id缴款人证件编号String(24)可空t_user_id_type缴款人证件类型String(2)可空t_username缴款人姓名String(10)可空t_name 订单名称 String(64)t_summary 订单摘要 String(200)t_total_fee 交易金额 Numbert_moneytype币种String(1)0为人民币，1为美元默认为人民币可空t_timeout 超时时间 String首信易不支持设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。

取值范围：1m～15dm-分钟，h-小时，d-天，1c-当天（无论交易何时创建，都在0点关闭）该参数数值不接受小数点，如1.5h，可转换为90m可空t_notify_url 服务器异步通知页面路径String(200)服务器主动通知商户网站里指定的页面http路径只支持支付宝，首信易只能在支付项目中定义可空T_return_url 页面跳转同步通知页面路径String(200)可空t_show_url 商品展示网址String(200)收银台页面上，商品展示的超链接可空t_extra_common_param 公用回传参数String(64)如果用户请求时传递了该参数，则返回给商户时会回传该参数可空t_fptt发票抬头String(512)多个发票，用|分割可空t_version接口的版本号String(4)接口升级后，用于向下兼容t_sign 签名String(32)调用支付宝接口参数参数中文名称类型（字节长度） 参数说明 值service 接口名称 String 接口名称 create_direct_pay_by_user partner 合作者身份ID String(16) 签约的支付宝账号对应的支付宝唯一用户号。

以2088开头的16位纯数字组成固定，收付平台在支付宝申请的_input_charset 参数编码字符集String 商户网站使用的编码格式，如utf-8、gbk、gb2312等gbk sign_type 签名方式 String DSA、RSA、MD5三个值可选，必须大写MD5 sign 签名 String 请参见“9 签名机制”按支付宝规则生成notify_url 服务器异步通知页面路径String(190) 支付宝服务器主动通知商户网站里指定的页面http路径固定return_url 页面跳转同步通知页面路径String(200) 支付宝处理完请求后，当前页面自动跳转到商户网站里指定页面的http路径固定error_notify_url 请求出错时的通知页面路径String(200) 当商户通过该接口发起请求时，如果出现提示报错，支付宝会根据“12.7 item_orders_info出错时的通知错误码”和“12.8 请求出错时的通知错误码”通过异步的方式发送通知给商户该功能需要联系支付宝开通固定或空out_trade_no 商户网站唯一订单号String(64) 支付宝合作商户网站唯一订单号。

合作方编号+订单号subject 商品名称 String(256) 商品的标题/交易标题/订单标题/订单关键字等该参数最长为128个汉字订单名称payment_type 支付类型 String(4) 取值范围请参见附录“12.6 收款类型”默认值为：1（商品购买）注意： 支付类型为“47”时，公共业务扩展参数（extend_param）中必须包含凭证号（evoucheprod_evouche_id）参数名和参数值1 seller_id 卖家支付宝账户号String(16) 卖家支付宝账号对应的支付宝唯一用户号以2088开头的纯16位数字在支付项目表中定义total_fee 交易金额 Number 该笔订单的资金总额，单位为RMB-Yuan取值范围为[0.01，100000000.00]，精确到小数点后两位订单金额show_url 商品展示网址String(400) 收银台页面上，商品展示的超链接业务系统提供paymethod 默认支付方式String 取值范围： l creditPay（信用支付） l directPay（余额支付） 如果不设置，默认识别为余额支付 说明： 必须注意区分大小写。

directPay extra_common_param 公用回传参数String(100) 如果用户请求时传递了该参数，则返回给商户时会回传该参数收付平台流水号+付款人姓名+业务系统扩展数据it_b_pay 超时时间 String 设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭取值范围：1m～15dm-分钟，h-小时，d-天，1c-当天（无论交易何时创建，都在0点关闭）该参数数值不接受小数点，如1.5h，可转换为90m该功能需要联系支付宝配置关闭时间如果业务系统提交的请求中不包括此参数，取支付项目表中的超时时间调用首信易支付接口参数参数中文名称类型（字节长度） 值v_mid 商户编号固定值+通道号v_oid订单编号订单生成日期(yyyymmdd)-固定的商户编号通道号（支付项目中定义） 合作方编号 订单号v_rcvname收货人姓名固定或证件编号v_rcvaddr收货人地址订单名称v_rcvtel收货人收付平台流水号v_rcvpost收货人邮政编码支付项目编号v_amount 交易金额 交易金额v_ymd订单产生日期订单产生日期v_ordmail订货人邮件固定v_moneytype币种币种v_url返回商户页面地址固定v_md5info订单数字指纹按首信易支付规则生成页面跳转同步通知第三方支付系统对交易请求处理完成后，会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。

因为各第三方支付平台返回的内容有差异，所以必须先返回收付平台，由平台进行处理后再跳转到合作方的业务系统因用户有可能关闭浏览器等原因，此通知机制不能保证100%有效流程：1. 收到第三方支付平台的通知2. 验证签名3. 调用天财系统webservice生成凭单并更新流水状态（可选）4. 根据合作方业务系统的密钥生成签名5. 浏览器重定向到跳转到合作方业务系统6. 向第三方支付系统返回成功返回给合作方业务系统的内容有：参数中文名称类型（字节长度） 参数说明 来源T_id收付平台流水号收付平台T_out_trade_no商户网站唯一订单。