《银联商务支付调用接口规范》由会员分享,可在线阅读,更多相关《银联商务支付调用接口规范(6页珍藏版)》请在金锄头文库上搜索。
1、 1 / 6 V1.0银联商务德赢订单支付应用调用接口规范V1.0 2 / 6 V1.0技术管理部2016 年 7 月 19 日版本控制信息版本 日期 拟稿和修改 审核 说明V1.0 2016.7.19 池如海 此版本为试用待修订版。 3 / 6 V1.01.引言1.1 目的为指导第三方应用开发人员调用银联商务 U 架构 Html5 应用程序提供的标准支付接口进行应用的开发,特制订此规范。1.2 适用范围本规范用适用于调用银联商务 U 架构 Html5 应用程序进行标准支付流程应用开发的开发人员,用于指导和规范标准银行卡程序的使用。2.方案采用 startActivityForResult 机
2、制基本原理:应用 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
3、 - 应用名称transId - 调用的业务编码transData - Json 格式数据,按照业务数据需要,在另行协商。3.第三方集成 jar 包调用接口说明使用 jar 包中的 AppHelper 辅助类进行调用,调用示例如下:/* Context - 调用上下文* transApp - 调用的 H5 应用名称,详见规范文档定义* transType - 调用的业务名称,详见规范文档定义* json - 业务调用数据,详见规范文档定义*/AppHelper.callTrans(Context ctx,String transApp,String transType,JSONObject 4
4、 / 6 V1.0json);通过回调机制获取返回信息,获取到 map 后,按照固定的键获取键值。示例代码如下:Map map = AppHelper.filterTransResult(data);result.append(AppHelper.TRANS_APP_NAME + : +map.get(AppHelper.TRANS_APP_NAME) + rn);result.append(AppHelper.TRANS_BIZ_ID + : +map.get(AppHelper.TRANS_BIZ_ID) + rn);result.append(AppHelper.RESULT_CODE
5、+ : +map.get(AppHelper.RESULT_CODE) + rn);result.append(AppHelper.RESULT_MSG + : +map.get(AppHelper.RESULT_MSG) + rn);result.append(AppHelper.TRANS_DATA + : +map.get(AppHelper.TRANS_DATA) + rn);appHelper.RESULT_CODE -1 表示无调用应用-2 表示无调用业务0 表示调用接口成功打印功能调用:AppHelper.callPrint(this, fname);其中入参分别为当前 Acti
6、vity、需要打印的图片地址(手机上的公共地址) 。上层应用开发需将打印的内容组成一张图片,传给打印接口,进行打印。4.接口设计4.1 银行卡收单4.1.1 消费方法名 描述 调用该方法进行消费入参说明序号 字段名 数据类型 Size 是否必需 说明1 appName String 是 传德赢收款2 transId String 是 消费;3 transData String 是Json 格式字符串数据。amt:交易金额; 5 / 6 V1.0exOrderNo:德赢订单号;出参说明1 appName String 是 传德赢收款2 transId String 是 消费;3 resultCo
7、de String 是调用接口返回码,为0 时返回 transData4 resultMsg String 是resultCode 描述信息5 transData String 是Json 格式字符串数据:resCode:返回码;resDesc:返回信息描述;以下为返回码 00 时出现;exOrderNo:德赢订单号;merchantName:商户名; merchantNo:商户编号; terminalNo:终端编号; operNo:操作员号;amt:交易金额;batchNo:批次号;traceNo:凭证号;refNo:参考号;authNo:授权码;expDate:卡片有效期;cardNo:卡
8、号;cardIssuerCode:发卡行 ID;cardAcquirerCode:收单行 ID;cardInputType:卡片输入方式;transChnName:交易中文名称; transEngName:交易英文名称; 6 / 6 V1.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。