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

银联商务有限公司技术管理部1/6V1.0银联商务德赢订单支付应用调用接口规范V1.0技术管理部2016年7月19日银联商务有限公司技术管理部2/6V1.0版本控制信息版本日期拟稿和修改审核说明V1.02016.7.19池如海此版本为试用待修订版。银联商务有限公司技术管理部3/6V1.01.引言1.1目的为指导第三方应用开发人员调用银联商务U架构Html5应用程序提供的标准支付接口进行应用的开发，特制订此规范。1.2适用范围本规范用适用于调用银联商务U架构Html5应用程序进行标准支付流程应用开发的开发人员，用于指导和规范标准银行卡程序的使用。2.方案采用startActivityForResult机制基本原理：应用A通过startActivityForResult方式调用应用B，应用B收到传递过来的Bundle数据进行处理。在处理完成之后，应用B通过setResult，并且finish自己的Activity。应用A在onActivityResult接收到处理结果。要求：1）应用B定义接收用的Action，并且该Action唯一。2）Bundle数据必须传appName键值、transId键值，其它键值由调用者与资源包双方约定。ActionName：com.ums.transcontroller.callBundle：appName-应用名称transId-调用的业务编码transData-Json格式数据，按照业务数据需要，在另行协商。3.第三方集成jar包调用接口说明使用jar包中的AppHelper辅助类进行调用，调用示例如下：/***Context-调用上下文*transApp-调用的H5应用名称，详见规范文档定义*transType-调用的业务名称，详见规范文档定义*json-业务调用数据，详见规范文档定义*/AppHelper.callTrans(Contextctx,StringtransApp,StringtransType,JSONObject银联商务有限公司技术管理部4/6V1.0json);通过回调机制获取返回信息，获取到map后，按照固定的键获取键值。示例代码如下：MapString,Stringmap=AppHelper.filterTransResult(data);result.append(AppHelper.TRANS_APP_NAME+:+map.get(AppHelper.TRANS_APP_NAME)+\r\n);result.append(AppHelper.TRANS_BIZ_ID+:+map.get(AppHelper.TRANS_BIZ_ID)+\r\n);result.append(AppHelper.RESULT_CODE+:+map.get(AppHelper.RESULT_CODE)+\r\n);result.append(AppHelper.RESULT_MSG+:+map.get(AppHelper.RESULT_MSG)+\r\n);result.append(AppHelper.TRANS_DATA+:+map.get(AppHelper.TRANS_DATA)+\r\n);appHelper.RESULT_CODE-1表示无调用应用-2表示无调用业务0表示调用接口成功打印功能调用：AppHelper.callPrint(this,fname);其中入参分别为当前Activity、需要打印的图片地址（手机上的公共地址）。上层应用开发需将打印的内容组成一张图片，传给打印接口，进行打印。4.接口设计4.1银行卡收单4.1.1消费方法名描述调用该方法进行消费入参说明序号字段名数据类型Size是否必需说明1appNameString是传‘德赢收款’2transIdString是消费；3transDataString是Json格式字符串数据。amt:交易金额；银联商务有限公司技术管理部5/6V1.0exOrderNo：德赢订单号；出参说明1appNameString是传‘德赢收款’2transIdString是消费；3resultCodeString是调用接口返回码，为0时返回transData4resultMsgString是resultCode描述信息5transDataString是Json格式字符串数据：resCode:返回码；resDesc：返回信息描述；以下为返回码00时出现；exOrderNo：德赢订单号；merchantName:商户名；merchantNo:商户编号；terminalNo:终端编号；operNo:操作员号；amt:交易金额；batchNo:批次号；traceNo:凭证号；refNo:参考号；authNo:授权码；expDate:卡片有效期；cardNo:卡号；cardIssuerCode:发卡行ID；cardAcquirerCode：收单行ID；cardInputType:卡片输入方式；transChnName:交易中文名称；transEngName:交易英文名称；银联商务有限公司技术管理部6/6V1.0date:日期；time:时间；memInfo:备注isReprint:重打印标志；vendor:供应商名称；cardOrg卡组织；serviceNo:服务热线；model:机具型号；version:应用版本；ARQC:ARQC；UnprNo:UnprNo；ATC:ATC；TVR:TVR；TSI:TSI；AID:AID；AIP:AIP；APPLAB:APPLAB；APPNAME:APPNAME；CVM:CVM；TermCap:TermCap；IAD:IAD；CSN:CSN。