資源描述:
《銀聯(lián)商務(wù)支付調(diào)用接口規(guī)范.doc》由會(huì)員上傳分享,免費(fèi)在線(xiàn)閱讀,更多相關(guān)內(nèi)容在教育資源-天天文庫(kù)。
1、銀聯(lián)商務(wù)有限公司技術(shù)管理部銀聯(lián)商務(wù)德贏訂單支付應(yīng)用調(diào)用接口規(guī)范V1.0技術(shù)管理部2016年7月19日6/6V1.0銀聯(lián)商務(wù)有限公司技術(shù)管理部版本控制信息版本日期擬稿和修改審核說(shuō)明V1.02016.7.19池如海此版本為試用待修訂版。6/6V1.0銀聯(lián)商務(wù)有限公司技術(shù)管理部1.引言1.1目的為指導(dǎo)第三方應(yīng)用開(kāi)發(fā)人員調(diào)用銀聯(lián)商務(wù)U架構(gòu)Html5應(yīng)用程序提供的標(biāo)準(zhǔn)支付接口進(jìn)行應(yīng)用的開(kāi)發(fā),特制訂此規(guī)范。1.2適用范圍本規(guī)范用適用于調(diào)用銀聯(lián)商務(wù)U架構(gòu)Html5應(yīng)用程序進(jìn)行標(biāo)準(zhǔn)支付流程應(yīng)用開(kāi)發(fā)的開(kāi)發(fā)人員,用于指導(dǎo)和規(guī)范標(biāo)準(zhǔn)銀行卡
2、程序的使用。2.方案采用startActivityForResult機(jī)制基本原理:應(yīng)用A通過(guò)startActivityForResult方式調(diào)用應(yīng)用B,應(yīng)用B收到傳遞過(guò)來(lái)的Bundle數(shù)據(jù)進(jìn)行處理。在處理完成之后,應(yīng)用B通過(guò)setResult,并且finish自己的Activity。應(yīng)用A在onActivityResult接收到處理結(jié)果。要求:1)應(yīng)用B定義接收用的Action,并且該Action唯一。2)Bundle數(shù)據(jù)必須傳appName鍵值、transId鍵值,其它鍵值由調(diào)用者與資源包雙方約定。ActionNa
3、me:com.ums.transcontroller.callBundle:appName-應(yīng)用名稱(chēng)transId-調(diào)用的業(yè)務(wù)編碼transData-Json格式數(shù)據(jù),按照業(yè)務(wù)數(shù)據(jù)需要,在另行協(xié)商。3.第三方集成jar包調(diào)用接口說(shuō)明使用jar包中的AppHelper輔助類(lèi)進(jìn)行調(diào)用,調(diào)用示例如下:/***Context-調(diào)用上下文*transApp-調(diào)用的H5應(yīng)用名稱(chēng),詳見(jiàn)規(guī)范文檔定義*transType-調(diào)用的業(yè)務(wù)名稱(chēng),詳見(jiàn)規(guī)范文檔定義*json-業(yè)務(wù)調(diào)用數(shù)據(jù),詳見(jiàn)規(guī)范文檔定義*/AppHelper.callTran
4、s(Contextctx,StringtransApp,StringtransType,JSONObject6/6V1.0銀聯(lián)商務(wù)有限公司技術(shù)管理部json);通過(guò)回調(diào)機(jī)制獲取返回信息,獲取到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表示無(wú)調(diào)用應(yīng)用-2表示無(wú)調(diào)用業(yè)務(wù)0表示調(diào)用接口成功打印功能調(diào)用:AppHelper.callPrint(this,fname);其中入?yún)⒎謩e為當(dāng)前Activity、需要打印的圖片地址(手機(jī)上的公共地址)。上層應(yīng)用開(kāi)發(fā)需將打印的內(nèi)容組成一張圖片,傳給打印接口,進(jìn)行打印。4.接口設(shè)計(jì)4.1銀行卡收單4.1.1消費(fèi)方法名描述調(diào)用該方法進(jìn)行消費(fèi)入?yún)⒄f(shuō)明序號(hào)字段名數(shù)據(jù)類(lèi)型Size
7、是否必需說(shuō)明1appNameString是傳‘德贏收款’2transIdString是消費(fèi);3transDataString是Json格式字符串?dāng)?shù)據(jù)。amt:交易金額;6/6V1.0銀聯(lián)商務(wù)有限公司技術(shù)管理部exOrderNo:德贏訂單號(hào);出參說(shuō)明1appNameString是傳‘德贏收款’2transIdString是消費(fèi);3resultCodeString是調(diào)用接口返回碼,為0時(shí)返回transData4resultMsgString是resultCode描述信息5transDataString是Json格式字符串
8、數(shù)據(jù):resCode:返回碼;resDesc:返回信息描述;以下為返回碼00時(shí)出現(xiàn);exOrderNo:德贏訂單號(hào);merchantName:商戶(hù)名;merchantNo:商戶(hù)編號(hào);terminalNo:終端編號(hào);operNo:操作員號(hào);amt:交易金額;batchNo:批次號(hào);traceNo:憑證號(hào);refNo:參考號(hào);authNo:授權(quán)碼;