银联商务支付调用接口规范.doc

《银联商务支付调用接口规范.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、银联商务有限公司技术管理部银联商务德赢订单支付应用调用接口规范V1.0技术管理部2016年7月19日6/6V1.0银联商务有限公司技术管理部版本控制信息版本日期拟稿和修改审核说明V1.02016.7.19池如海此版本为试用待修订版。6/6V1.0银联商务有限公司技术管理部1.引言1.1目的为指导第三方应用开发人员调用银联商务U架构Html5应用程序提供的标准支付接口进行应用的开发，特制订此规范。1.2适用范围本规范用适用于调用银联商务U架构Html5应用程序进行标准支付流程应用开发的开发人员，用于指导和规范标准银行卡

2、程序的使用。2.方案采用startActivityForResult机制基本原理：应用A通过startActivityForResult方式调用应用B，应用B收到传递过来的Bundle数据进行处理。在处理完成之后，应用B通过setResult，并且finish自己的Activity。应用A在onActivityResult接收到处理结果。要求：1）应用B定义接收用的Action，并且该Action唯一。2）Bundle数据必须传appName键值、transId键值，其它键值由调用者与资源包双方约定。ActionNa

3、me：com.ums.transcontroller.callBundle：appName-应用名称transId-调用的业务编码transData-Json格式数据，按照业务数据需要，在另行协商。3.第三方集成jar包调用接口说明使用jar包中的AppHelper辅助类进行调用，调用示例如下：/***Context-调用上下文*transApp-调用的H5应用名称，详见规范文档定义*transType-调用的业务名称，详见规范文档定义*json-业务调用数据，详见规范文档定义*/AppHelper.callTran

4、s(Contextctx,StringtransApp,StringtransType,JSONObject6/6V1.0银联商务有限公司技术管理部json);通过回调机制获取返回信息，获取到map后，按照固定的键获取键值。示例代码如下：Mapmap=AppHelper.filterTransResult(data);result.append(AppHelper.TRANS_APP_NAME+":"+map.get(AppHelper.TRANS_APP_NAME)+"r");r

5、esult.append(AppHelper.TRANS_BIZ_ID+":"+map.get(AppHelper.TRANS_BIZ_ID)+"r");result.append(AppHelper.RESULT_CODE+":"+map.get(AppHelper.RESULT_CODE)+"r");result.append(AppHelper.RESULT_MSG+":"+map.get(AppHelper.RESULT_MSG)+"r");result.append(AppHelper.T

6、RANS_DATA+":"+map.get(AppHelper.TRANS_DATA)+"r");appHelper.RESULT_CODE-1表示无调用应用-2表示无调用业务0表示调用接口成功打印功能调用：AppHelper.callPrint(this,fname);其中入参分别为当前Activity、需要打印的图片地址（手机上的公共地址）。上层应用开发需将打印的内容组成一张图片，传给打印接口，进行打印。4.接口设计4.1银行卡收单4.1.1消费方法名描述调用该方法进行消费入参说明序号字段名数据类型Size

7、是否必需说明1appNameString是传‘德赢收款’2transIdString是消费；3transDataString是Json格式字符串数据。amt:交易金额；6/6V1.0银联商务有限公司技术管理部exOrderNo：德赢订单号；出参说明1appNameString是传‘德赢收款’2transIdString是消费；3resultCodeString是调用接口返回码，为0时返回transData4resultMsgString是resultCode描述信息5transDataString是Json格式字符串

8、数据：resCode:返回码；resDesc：返回信息描述；以下为返回码00时出现；exOrderNo：德赢订单号；merchantName:商户名；merchantNo:商户编号；terminalNo:终端编号；operNo:操作员号；amt:交易金额；batchNo:批次号；traceNo:凭证号；refNo:参考号；authNo:授权码；