收付平台接口方案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首信易不支持设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。取值范围：1m15d。m-分钟，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 设置未付款交易的超时时间，一旦超时，该笔交易就会自动被关闭。取值范围：1m15d。m-分钟，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商户网站唯一订单号合作方业务系统唯一订单号合作方业务系统t_item支付项目编号合作方业务系统t_subitem子项目编号合作方业务系统交易状态代码收付平台交易结果描述信息收付平台支付途径收付平台支付渠道第三方支付平台通知时间total_fee 交易金额 合作方业务系统t_moneytype币种第三方业务系统extra_common_param 公用回传参数如果用户请求时传递了该参数，则返回给商户时会回传该参数合作方业务系统sign 签名收付平台服务器异步通知第三方支付系统对交易请求处理完成后，会将处理的结果数据通过服务器主动通知的方式通知收付平台。收付平台进行处理后再通知合作方的业务系统。此方式有一定的延迟，但是比浏览器跳转通知方式的可靠性高的多。从第三方支付平台到收付平台和从收付平台到合作方业务系统都采用异步通知的方式，如果通知失败，都会重试多次。参数中文名称类型（字节长度） 参数说明 来源notify_id 通知校验ID 收付平台T_id收付平台流水号收付平台T_out_trade_no商户网站唯一订单号合作方业务系统唯一订单号合作方业务系统t_item支付项目编号合作方业务系统t_subitem子项目编号合作方业务系统交易状态代码收付平台交易结果描述信息收付平台支付途径收付平台支付渠道第三方业务系统通知时间收付平台gmt_payment 交易付款时间支付宝或收付平台total_fee 交易金额 合作方业务系统t_moneytype币种第三方业务系统extra_common_param 公用回传参数如果用户请求时传递了该参数，则返回给商户时会回传该参数合作方业务系统sign 签名收付平台流程：1. 收到第三方支付平台的通知2. 验证签名3. 拆分为单笔（仅对首信易）4. 判断是否已进行过处理5. 调用天财系统webservice生成凭单并更新流水状态6. 向第三方支付系统返回成功7. 根据合作方业务系统的密钥生成签名8. 通知合作方业务系统，返回success视为成功（如果失败重试n次，仍然失败记录错误日志）接收首信易转帐结果通知接口流程：1. 接收首信易转帐结果通知2. 生成到款记录并更新流水表相关字段3. 通知合作方业务系统（可选）支付宝入账定时任务支付宝未提供通知商户转帐结果接口，因为其是T+1转账，所以可用定时任务处理每日夜间运行，处理当日通过支付宝支付成功的流水，按支付项目生成到款记录，并更新流水相关字段，通知合作方业务系统（可选）接收发票信息接口由合作方业务系统调用，参数为订单号和发票信息列表退款接口由合作方业务系统调用，通知第三方支付平台退款退款通知接口第三方支付平台退款成功后，通知收付平台，收付平台再通知合作方业务系统按到款记录查询接口（收付平台也提供此界面）提供给合作方业务系统调用，参数为合作方编码和收款记录状态（可选），返回该合作方指定状态的收款记录按到款明细查询接口（收付平台也提供此界面）提供给合作方业务系统调用，参数为到款记录ID，返回此笔到款所对应的每笔订单号及其金额确认收款接口（收付平台也提供此界面）提供给合作方业务系统调用，参数为到款记录ID，用户核对无误后，通过此接口确认签名机制l 参数列表中，除去sign参数外，其他需要使用到的参数皆是要签名的参数。l 对参数名从a到z的顺序排序，若遇到相同首字母，则看第二个字母，以此类推。l 排序完成之后，再把所有参数以“&”字符连接起来l 没有值的参数无需传递，也无需包含到待签名数据中。 l 根据HTTP协议要求，传递参数的值中如果存在特殊字符（如：&、等），那么该值需要做URL Encoding，这样请求接收方才能接收到正确的参数值。这种情况下，待签名数据应该是原生值而不是encoding之后的值。例如：调用某接口需要对请求参数email进行数字签名，那么待签名数据应该是email=，而不是email=test%40数据库设计合作方信息表字段名中文名称类型（字节长度） 参数说明 是否可为空partner合作方编号varchar2(4)Name合作方名称varchar2(128)Key密钥varchar2(32)notify_url后台异步通知地址varchar2(200)支付项目表 Payment_item字段名中文名称类型（字节长度） 参数说明 是否可为空查询条件Payment_item_id支付项目编号Varchar2(6)是Payment_item_name支付项目名称Varchar2(128)是Payment_item_info支付项目描述Varchar2(1024)Payment_itemtype_id支付项目类型编号Varchar2(6)是partner合作方编号varchar2(4)是Payment_type支付方式varchar2(2)11：首信易支付12：支付宝 是Bmdm财务部门编码varchar2(3)Xmdm财务项目编码varchar2(12)Begin_Date开始日期DATETIME是End_date结束日期DATETIME是Payment_item_state支付项目状态varchar2(1)0：未提交 1：已提交2：已审核 Third_party_subAccount第三方支付子账户(首信易通道号或支付宝帐号)varchar2(200)MAINTAINER创建人AUDITOR审核人AUDIT_TIME审核时间支付项目类型表 Payment_itemtype字段名中文名称类型（字节长度） 参数说明 是否可为空Payment_itemtype_id支付项目类型编号varchar2(6)Payment_itemtype_name名称varchar2(32)Payment_itemtype_info描述信息varchar2(200)收入分配表 INCOME_DIVIDE字段名中文名称类型（字节长度） 参数说明 是否可为空ID编号varchar2(6)Payment_item_id支付项目编号Varchar2(6)Bmdm财务部门编码varchar2(3)Xmdm财务项目编码varchar2(12)DIVIDE_SCALE分配比例NUMBER01之间的小数DIVIDE_INFO描述信息varchar2(200)可空发票信息表 INVOICE字段名中文名称类型（字节长度） 参数说明 是否可为空ID编号INTEGERLs_id支付流水IDINTEGERpartner合作方编号VARCHAR2(4 BYTE)OUT_TRADE_NO订单编号VARCHAR2(32 BYTE)Money金额NUMBERFptt发票抬头varchar2(128)fp_state是否已打varchar2(1)到款记录表RECEIVABLE_RECORD字段名中文名称类型（字节长度） 参数说明 是否可为空查询条件ID到款记录IDINTEGERPAYMENT_ITEM_ID支付项目编号VARCHAR2(6 BYTE)是TOTAL_FEE到账金额NUMBERCOUNT明细笔数INTEGERPARTNER合作方编码VARCHAR2(4 BYTE)是PAYMENT_TYPE来源VARCHAR2(2 BYTE)ALLOCATION_GROUP_ID分配分组编码VARCHAR2(30 BYTE)THIRD_PARTY_SUBACCOUNT第三方支付子账户(首信易通道号或支付宝帐号)VARCHAR2(200 BYTE)BOOK_DATE入账日期DATE是SETTLED是否已确认VARCHAR2(1 BYTE)支付流水表PAYMENTRECORD字段名中文名称类型（字节长度） 参数说明 是否可为空查询条件Id流水IDINT是partner 合作方编号 Varchar2(4)是out_trade_no商户网站唯一订单号Varchar2(32)合作方业务系统唯一订单号是item支付项目编号Varchar2(6)是sub_it