內(nèi)容分析案例uexapplepay

startChnaUncommtShppcommtShppcommtAuthorzedResuonChnaUnonPayFnonShpponShpponPaymentAuthoronPayFnonButtonC1、簡(jiǎn)2、API概3、術(shù)語(yǔ)4、FAQ常見問5、接入指6、更新歷1、簡(jiǎn)AppePay支付插該插件實(shí)現(xiàn)了 的AppePay支付功能本文的的是為了開發(fā)能夠更好更快地將API集成到自己的項(xiàng)中，在使用前最好先使用好 這里以【參 uapIDE為開發(fā)者工具開發(fā)，然后集成到自己的 、UI展插件測(cè)試用例與源 :點(diǎn)擊插件中心至插件詳情頁(yè)(插件測(cè)試用例與插件源碼已經(jīng)提供、平臺(tái)版本支本插件的所有API默認(rèn)支持僅iOS9.2+操作系統(tǒng),不支持Android.、接口有效本插件所有API默認(rèn)在插件版本 用在后續(xù)版本中新添加的接口會(huì)在文檔中額外說明2、API概在進(jìn)行插件調(diào)試之前,請(qǐng)先閱讀接入指引并按其步驟進(jìn)行接入操作,否則無(wú)法進(jìn)行支付操作canMakePayment//檢測(cè)能否進(jìn)行AppplePay支說明檢測(cè)能否進(jìn)行App參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str否接口所需數(shù)據(jù),形式見下各字段含義如下參 參名 類

是必 說

指定進(jìn)行AppePay的支付網(wǎng)絡(luò),由UexAppePayNetworkKey構(gòu)成的數(shù)組,詳見[術(shù)語(yǔ)表-UexAppePayNetworkKey].不傳時(shí)默認(rèn)為系統(tǒng)選的所有支付網(wǎng)絡(luò)返回值Number類型,檢測(cè)結(jié)果,是一個(gè)UexAppeCanMakePaymentStatus,詳見術(shù)語(yǔ)表-UexApp示例varvarparams{vardataf(resut!0){aert("不能進(jìn)行AppePay支付}startChinaUnionPay//調(diào)起銀聯(lián)ApplePay支說明調(diào)用銀聯(lián)封裝的AppePay方法和StartPay方法相比,此方法集成更加簡(jiǎn)單,但定制化程度低,并且只支持中國(guó)銀聯(lián)支付.調(diào)用此接口前,請(qǐng)先調(diào)用uexAppePay.canMakePayment接口并限定支付網(wǎng)絡(luò)為"ChnaUnonPay"來檢測(cè)是否以進(jìn)行支付參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下{,mode:,各字段含義如下參數(shù)名稱

參 是類 必 說

銀聯(lián)提供的交易流水號(hào)是 是 測(cè)試類型,取值為"00"、"01"."00"表示銀聯(lián)正式環(huán)境,若開發(fā)者已經(jīng) 聯(lián)支付,用正式環(huán)境是參數(shù)名 類 必 說 試;"01"表示銀聯(lián)測(cè)試環(huán)境,測(cè)試環(huán)境僅用于測(cè)試插件功能是否dentfer

的返回值Number類型,檢測(cè)結(jié)果,是一個(gè)UexAppePayStartPayResut,詳見術(shù)語(yǔ)表-UexAppePayStartPayResu示例varparams vardataf(resut!0){aert("調(diào)起支付失敗}注: 以獲取測(cè)試用的startPay調(diào)起ApplePay支說明調(diào)用OS原生的AppePay方法和startChinaUnionPay方法相比,此方法集成較復(fù)雜,但定制化程度高,支持所有ApplePay支持的支付調(diào)用此接口前,請(qǐng)先調(diào)用uexAppePay.canMakePayment接口并限定支付網(wǎng)絡(luò)為你的 支持的支付網(wǎng)絡(luò)來檢測(cè)是否以進(jìn)行支付.參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下varvar{merchantIdent{}]bngContactRequredFag:,{prce:,deta:}]各字段含義如下參數(shù)名稱

參 是類 必 說merchantIdentferStrg

在蘋果開發(fā)者中心配置的merchant的否賬單處理標(biāo)準(zhǔn),UexAppePayMerchantCapabty詳見術(shù)語(yǔ)表-UexAppePayMerchantCapabty,不傳時(shí)默認(rèn)為15否進(jìn)行AppePay的支付網(wǎng)絡(luò),UexAppePayNetworkKey,詳見術(shù)語(yǔ)表-UexAppePayNetworkKey.不傳時(shí)默認(rèn)為系統(tǒng)選的所有支付網(wǎng)絡(luò)否,表示此次支付的默認(rèn)貨幣."CNY"g否2ISOCountryCode,表示處理此次支付的區(qū)域."CN"g是b否uredFshpp否 equredFshpp否UexAppePayShppngType不傳時(shí)默認(rèn)為shpp否ShppngMethodObject構(gòu)成的數(shù)組.y格.此字段通過其他接口更新,開始時(shí)以不傳appcatStrg 校驗(yàn)字段. 任何字符串.傳入此參數(shù),即在最后獲取的支付token中解析出傳入字段的SHA-256PaymentObject表示這個(gè)訂單中的賬單信息,其各字段含義參名參類是必說是表示這個(gè)訂單的收款/機(jī)否表示此次訂單的明細(xì),是由ItemObject構(gòu)成的數(shù)組.ItemObject各字段說明詳見下方表格.此參Pr

表示這個(gè)訂單的總金額,此參數(shù)唯一確定了此訂單的支付金額.見下方說說明:對(duì)于totaPr不傳此參數(shù)時(shí),插件會(huì)自動(dòng)將傳入的所有tems中的價(jià)格相加作為totaPr若items參數(shù)不傳,則此參數(shù)必傳,否則支付會(huì)報(bào)錯(cuò)若傳入此參數(shù),則不會(huì)進(jìn)行tems價(jià)格計(jì)算,以傳入的參數(shù)為準(zhǔn)ItemObject表示賬單中的一個(gè)項(xiàng),各字段含義如下參數(shù)名稱參數(shù)類型是否必選說Str是項(xiàng)說明,比如物品名稱/運(yùn)費(fèi)/折扣名稱/pr否項(xiàng)價(jià)格,支持用負(fù)數(shù)表示折扣.不傳時(shí)表示此項(xiàng)價(jià)格還未確定,注:價(jià)格未確定的項(xiàng)在計(jì)算totaPrce時(shí),按0處理 MethodObject表示一種物流方式,各字段含義如下參數(shù)名 參數(shù)類 是否必 說 Str 物流名pr 物流價(jià)格.不傳時(shí)表示此價(jià)格還未確定,會(huì)用...表dentf Str 唯一標(biāo)識(shí)符,傳非空字符串,同一個(gè)訂單內(nèi)不重返回值

Str 此物流方式的一些額外說明,比如"3天內(nèi)送達(dá)"等等.以不Number類型,打開支付頁(yè)面的結(jié)果,是一個(gè)UexAppePayStartPayResut,詳見術(shù)語(yǔ)表-UexAppePayStartPayResu示例varparamsmerchantIdentfer:" merchantCapabty:4,{prce:5{prce:8.5{prce:-1.2]{prce:1,deta:"deta{prce:2,deta:"deta}vardataf(resut!0){aert("調(diào)起支付失敗}commitPaymentMethodChange//確認(rèn)支付方式變化說明 具有額外折扣等功能參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下var{各字段含義如下參數(shù)名稱參數(shù)類型是否必選說否是一個(gè)PaymentObject同StartPay中的payment參數(shù).返回值Booean類型,調(diào)用接口結(jié)果.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起,必須重新調(diào)用此接口var{{{prce:5{prce:8.5{prce:-1.2{ prce:-3]}}varresut f(!resut){aert("傳入?yún)?shù)錯(cuò)誤此時(shí)應(yīng)該重新調(diào) } MethodChange//確認(rèn)物流方式變化說明在onShppngMethodChange 以在此方法中更新此次訂單的賬單,實(shí)現(xiàn)諸如對(duì)不同的物流方式有不同的總價(jià)格等功能參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下{各字段含義如下參數(shù)名稱參數(shù)類型是否必選說否是一個(gè)PaymentObject同StartPay中的payment參數(shù).返回值Booean類型,調(diào)用接口結(jié)果.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起,必須重新調(diào)用此接口var{{{prce:5{prce:8.5{prce:-1.2{prce:5]}}varresut f(!resut){aert("傳入?yún)?shù)錯(cuò)誤此時(shí)應(yīng)該重新調(diào) mtShppngMethodChange方} ContactChange//確認(rèn)物流信息變化說明在onShpp 觸發(fā)之后必須調(diào)用此方法,否則支付無(wú)法正常進(jìn)行下以在此方法中更新此次訂單的賬單和物流方式,等功能參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下{,各字段含義如下參數(shù)名稱

是否 說 是一個(gè)PaymentObject,同StartPay中的payment參數(shù).不傳時(shí)表示賬單無(wú)變shpp 是一個(gè)由ShppngMethodObject,同StartPay中的shppngMethods參數(shù).不傳時(shí)表示訂支持的物流方式無(wú)變nvad

地址是否無(wú)效.傳true時(shí)會(huì)讓支付界面提示用戶修改當(dāng)前的地址.默認(rèn)為 返回值Booean,調(diào)用接口結(jié)果.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起,必須重新調(diào)用此接口varparams{prce:10,deta:"deta{prce:5,deta:"deta}]}varresut mtShppngContactChange(JSON.strngfy(params));f(!resut){aert("傳入?yún)?shù)錯(cuò)誤此時(shí)應(yīng)該重新調(diào) mtShppngContactChange方}commitAuthorizedResult//確認(rèn)訂單支付結(jié)說明在onPaymentAuthorzed 參數(shù)名 參數(shù)類 是否必 說 Str 接口所需數(shù)據(jù),形式見下{各字段含義如下參數(shù)名稱參數(shù)類型是否必選說resuBoo是參數(shù)名 參數(shù)類 是否必 說返回值Booean,調(diào)用接口結(jié)果.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起,必須重新調(diào)用此接口var{}f(!resut){aert("傳入?yún)?shù)錯(cuò)誤//此時(shí)應(yīng)該重新調(diào)用uexAppePay.onPaymentAuthorzed方}addButton//添加ApplePay按說明提供一個(gè)符合Appe的AppePay注意,Appe的AppePay設(shè)計(jì)規(guī) 此類按鈕必須用于AppePay支付,用于其他用途會(huì)導(dǎo)致你的App被Appe 參數(shù)參數(shù)名 參數(shù)類 是否必 說 Str 接口所需數(shù)據(jù),形式見下{styscroW各字段含義如下參數(shù)名稱參數(shù)類型是否必選說dStr是按鈕的唯一標(biāo)x是按鈕距離屏幕左側(cè)的距離,單位y是按鈕距離屏幕方的距離,單位是按鈕寬度,單位he是按鈕寬度,單位否按鈕類型,插件提供了3中不同的按鈕類型,請(qǐng)傳0、1或者2,不傳時(shí)默認(rèn)為sty否按鈕風(fēng)格,插件提供了3中不同的按鈕風(fēng)格,請(qǐng)傳0、1或者2,不傳時(shí)默認(rèn)為scroWBoo否設(shè)置按鈕是否跟隨網(wǎng)頁(yè)滑動(dòng),不傳時(shí)默認(rèn)為fa返回值Booean類型,是否添加按鈕成功.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起 y:wdth:heght:60,d:sty}removeButton//移除ApplePay按說明移除由addButton接口添加的AppePay按鈕參數(shù)名稱參數(shù)類型是否必選說Str是接口所需數(shù)據(jù),形式見下{各字段含義如下參數(shù)名稱參數(shù)類型是否必選說dStr是按鈕的唯一標(biāo)返回值Booean類型,是否刪除按鈕成功.若為fase,一般為參數(shù)錯(cuò)誤或者不完整引起vardatad:} 方onChinaUnionPayFinish//銀聯(lián)ApplePay支付結(jié)束 方說明在調(diào)用在調(diào)用uexAppePay.startChnaUnonPay接口后,通過此接口 參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str是返回?cái)?shù)據(jù),形式見下{resut:,各字段含義如下參數(shù)名參數(shù)類是否必說resu是支付結(jié)果0-支付成功1-支付失敗2-用戶取消了支付3-支付結(jié)果不確定,此時(shí)應(yīng)需查詢商戶Str否支付失敗時(shí)會(huì)通過此字段返回失敗的oStr否支付的額外信息會(huì)通過此字段返回 此字段由銀聯(lián)SDK直接提供,請(qǐng)參考銀聯(lián)的相關(guān)文示例on(nfo){aert(nfo);} //支付方式變化的方說明在調(diào)用uexAppePay.startPay接口后,當(dāng)用戶選擇或者更改支付方式時(shí),會(huì)觸發(fā)此觸發(fā)此之后,必須調(diào)用commitPaymentMethodChange來確認(rèn)支付方式變化參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str是返回?cái)?shù)據(jù),形式見下是一個(gè){type:,各字段含義如下參數(shù)名稱

是否 說參數(shù)名稱

支付方式,是一個(gè)UexAppePayPaymentMethodType,詳見術(shù)語(yǔ)表exApp

Str 支付的展示名,僅在申請(qǐng)支付 時(shí)才會(huì)有此字 Strng 支付網(wǎng)絡(luò),僅在申請(qǐng)支付許時(shí)才會(huì)有此字段示例:on(nfo){aert(nfo);} //物流聯(lián)系人變化 方說明在調(diào)用uexAppePay.startPay接口后,當(dāng)用戶選擇或者更改物流聯(lián)系人時(shí),會(huì)觸發(fā)此 之后,必須調(diào)用commitShip ContactChange來確認(rèn)物流聯(lián)系人變化參數(shù)參數(shù)名 參數(shù)類 是否必 說 Str 返回?cái)?shù)據(jù),形式見下paramsContactObject序列化得到的JSON字符串ContactObjectvaraddressInfo:{//聯(lián)系人址cty:,//城市} gvenName:,//名famyName:,//姓nckName:,//}注 4個(gè)主參數(shù)分別對(duì)應(yīng)了UexAppePayContactRequredFag的4個(gè)枚舉值以參數(shù)均為選參數(shù),具體參數(shù)是否存在,取決于用戶是否填入相應(yīng)的信息示例on(nfo){aert(nfo);} //物流方式變化 方說明在調(diào)用uexAppePay.startPay接口后,當(dāng)用戶選擇或者更改物流方式時(shí),會(huì)觸發(fā)觸發(fā) 之后,必須調(diào)用 MethodChange來確認(rèn)物流方式變參數(shù)參數(shù)名 參數(shù)類 是否必 說 Str 返回?cái)?shù)據(jù),形式見下params是一個(gè)ShppngMethodObject序列化得到的JSON字符串,字段介紹詳見startPay接口中的ShppngMethodObject{abe:,dentfer:,prce:,deta:}示例on(nfo){aert(nfo);}onPaymentAuthorized//用戶進(jìn)行支付 方說明在調(diào)用uexAppePay.startPay接口后,當(dāng)用戶確認(rèn)進(jìn)行支付時(shí),會(huì)觸發(fā)此 之后,必須調(diào)用commitAuthorizedResult來確認(rèn)支付結(jié)果參數(shù)參數(shù)名稱參數(shù)類型是否必選說Str是返回?cái)?shù)據(jù),形式見下varparamshppngMethod:,//可選,一個(gè)ShppngMethodObject,描述了用戶最終選擇的物流bngContact:,//可選,一個(gè)ContactObject(字段可參考o(jì)nShppngContactChange方法中的介紹),描述了賬單接收人的聯(lián)系人信息shppngContact:,//可選,一個(gè)ContactObject(字段可參考o(jì)nShppngContactChange方法中的介紹),描述了貨物接收人的聯(lián)系人信息paymentMethod:,//必選,一個(gè)PaymentMethodObject(字段可參考o(jì)nPaymentMethodChange方法中的介紹),描述了支付方式信息transactonIdentfer:,//必選,蘋果AppePay模塊生成的單標(biāo)識(shí)符data:,//加密過的支付信sgnature:,//簽名信息,用于校驗(yàn)此token是否有verson:,// transactonId:,//支付卡ID,根據(jù)支付的 data,僅verson為"RSA_v1"時(shí)存在ephemeraPubcKey:,//Ephemera公鑰僅verson為"EC_v1"時(shí)存在pubcKeyHash:,//二次加密key所用到的公鑰的SHA256Hash,用Base64編碼得到的}}}} 除非測(cè)試,否則絕對(duì)不要 端進(jìn)行 工作!正常的操作流程應(yīng)前端發(fā)送paymentInfo 得到支付結(jié)果返回給前端前端調(diào)用commtAuthorzedResut告訴插件支付結(jié)果,并展示給用戶on(nfo){aert(nfo);}mitError//支付提交變化發(fā)生錯(cuò)誤 方說明在調(diào)用 mtShppngMethodChange、 mtShppngContactChange mtAuthorzedResut這4個(gè)接口后,若提交失敗,會(huì)觸發(fā)此方法參數(shù)參數(shù)名 參數(shù)類 是否必 說 Str 返回?cái)?shù)據(jù),形式見下varparam 的方法類型0- mtAuthorzedResut,1- mtShppngMethodChange,2-uexmtPaymentMethodChange,3- }示例on(nfo){aert(nfo);}onPayFinish//支付結(jié)束 方說明在調(diào)用uexAppePay.startPay接口后,完成支付或者用戶取消支付時(shí),會(huì)調(diào)用此方法參數(shù)名 參數(shù)類 是否必 說 Str 返回?cái)?shù)據(jù),形式見下varparamresut:,//Number必選0-成功1-失敗2-支付被取}示例on(nfo){aert("onPayFnsh:"+nfo} //支付按鈕被點(diǎn)擊 方說明用戶點(diǎn)擊由uexAppePay.addButton設(shè)置的AppePay按鈕時(shí),會(huì)觸發(fā) 參數(shù)參數(shù)名 參數(shù)類 是否必 說 Str 返回?cái)?shù)據(jù),形式見下varparamsd://按鈕的唯一標(biāo)識(shí)示例on(nfo){aert(nfo);}3、術(shù)語(yǔ)UexAppePayNetworkKey是一系列字符串,代表了各 含ChnaUn 中國(guó)銀聯(lián)的借記卡 含 Amercan 運(yùn) MasterCardD DscoverCardPr 匯豐銀 的Pr abe InteracUexAppeCanMakePaymentStatus是一個(gè)Number類型的枚舉值,表示檢測(cè)是否支持AppePay的結(jié)果,非0時(shí)均表示不能進(jìn)行ApplePay支 含以進(jìn)行AppePay系統(tǒng)不支持,uexAppePay插件需要iOS9.2+設(shè)備不支持,見注賬號(hào)不支持,見注注1 前支持AppePay的設(shè)備型號(hào)Phone:Phone6,Phone6Pus,Phone6s,Phone6sPusPad:P ro,PadAr2,Padmn3,Padmn4注2:賬號(hào)不支持包含但不限于以下幾種情設(shè)備登錄的蘋果賬號(hào)未在Waet設(shè)備登錄的蘋果賬號(hào)處于鎖定狀態(tài),或者處于家 UexAppePayStartPayResut是一個(gè)Number類型的枚舉值,表示調(diào)用開始支付接口的結(jié)果,非0時(shí)均表示打開支付界面失敗 含義支付傳入的參數(shù)有設(shè)備或者系統(tǒng)不支其他未知錯(cuò)UexAppePayMerchantCapabty是一個(gè)Number類型的枚舉值,表示支持的支付處理標(biāo)準(zhǔn) 含義 3DSecure協(xié) EMV支 借記卡支其中其中3DS和EMV和借記卡.支付,傳4達(dá)到此效果UexAppePayContactRequredFag是一個(gè)Number類型的枚舉值,表示需要的聯(lián)系人信息如果同時(shí)需要多種信息,請(qǐng)將需要信息的值相加后作為最終結(jié)果傳入.比如,同時(shí)需要聯(lián)系人的名稱 ,請(qǐng)傳 含需要聯(lián)系人詳細(xì)地需要聯(lián)系需要聯(lián)系人 需要聯(lián)系人名 UexAppePayShppngType是一個(gè)Number類型的枚舉值,表示此訂單貨物的物流類型值含0表示由商家委托第進(jìn)1表示由商家自己進(jìn)2表示此商品需要去商提表示商家會(huì)將商品運(yùn)送至 自提點(diǎn),需要用戶去 自提點(diǎn)提取商UexAppePayPaymentMethodType是一個(gè)Number類型的枚舉值,表示此支付方式的類型 含未知Debt,CredPrepad,部分商家的 Store,部分商家聯(lián)合銀 ,比如AmazonStore4、FAQ常見問startPay和startChinaUnionPay這2個(gè)接口都能進(jìn)行ApplePay支付,我該用哪個(gè)如果您需要快速實(shí)現(xiàn)AppePay功能,并且只需要支持中國(guó)銀聯(lián) ,那么使的startChnaUnonPay接口 的AppePay支付,那么只能選擇startPay接口您應(yīng)該視您的實(shí)際使用情況選擇用哪個(gè)接口.它們的主要區(qū)別如下表

簡(jiǎn) 較復(fù)后端服務(wù)器壓 只需和銀聯(lián)服務(wù)器進(jìn)行交互,簡(jiǎn)單,壓力 需要進(jìn) 工作 后還要組織報(bào)文進(jìn)行支付,較復(fù)雜壓力前端UI定制程

極低,所有UI均有銀聯(lián)SDK定死,無(wú)法更 內(nèi),且必須是銀聯(lián)發(fā)布的支持AppePay的 國(guó)外以使用,支持所有支持AppePay的為什么我無(wú)法打開支付的界面?請(qǐng)確認(rèn)您在調(diào)用startPay或者startChnaUnonPay接口時(shí)傳入的merchantIdentfer無(wú)誤,并且此merchantIdent fg.xm中被我能否不用插件提供的ApplePay按鈕若您的App不需要考慮架問題(比如企 的OA等App),那么完全以用自己的若您的App需要發(fā)布至AppStore，您以用自己設(shè)計(jì)的UI,但必須要符合《AppePay識(shí)別標(biāo)志指南》，否則您的應(yīng)用會(huì)無(wú)法通過審核應(yīng)用在啟用ApplePay之后被拒了!為什么?AppePay有如下原因會(huì)導(dǎo)致您的應(yīng)用審核被AppePay頁(yè)面的UI不符合《AppePayAppePay按鈕不是用于進(jìn)行AppePay在不能進(jìn)行ApplePay支付的設(shè)備提示或者以選擇進(jìn)行ApplePay支付(正