省號百平臺支付接口技術(shù)規(guī)范V_第1頁
省號百平臺支付接口技術(shù)規(guī)范V_第2頁
省號百平臺支付接口技術(shù)規(guī)范V_第3頁
省號百平臺支付接口技術(shù)規(guī)范V_第4頁
省號百平臺支付接口技術(shù)規(guī)范V_第5頁
已閱讀5頁,還剩7頁未讀, 繼續(xù)免費閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)

文檔簡介

IWEB網(wǎng)上號百技術(shù)接口規(guī)范】

V1.0

2011年6月

湖北公眾

s錄

1.文檔說明.....................................................................3

1.1文檔目標.................................................................3

1.2閱讀對象................................................................3

1.3相關(guān)約定................................................................3

1.4業(yè)務(wù)及技術(shù)支持..........................................................3

2.業(yè)務(wù)描述及接口開發(fā)...........................................................3

2.1功能說明及流程..........................................................3

2.2商戶接入前提............................................................4

2.3參數(shù)說明................................................................6

2.3.1HTTP訂單支付請求接口.............................................6

2.3.2退款接口...........................................................8

2.4開發(fā)提示...............................................................10

2.4.1商戶對支付結(jié)果的處理.............................................10

3.參考資料....................................................................10

3.1出參類型說明............................................................10

1.文檔說明

1.1文檔目標

本文檔的目的是為WEB網(wǎng)上支付定義一個標準接口規(guī)范,以幫助各省號百及合作商戶

技術(shù)人員接入號百網(wǎng)上支付,并快速掌握號百網(wǎng)上支付相關(guān)功能,為業(yè)務(wù)開展提供支付服務(wù)。

1.2閱讀對象

對號百網(wǎng)上支付存在需求的公司、機構(gòu)及合作商戶的網(wǎng)上應(yīng)用開發(fā)人員、維護人員和業(yè)

務(wù)管理人員。

1.3相關(guān)約定

商戶:指已注冊成為號百用戶、并使用號百產(chǎn)品實現(xiàn)其收付費功能需求、為其用戶提供

各類產(chǎn)品或者相關(guān)服務(wù)的個人。

用戶:指在商戶網(wǎng)站等系統(tǒng)購物的個人。

購物:指用戶在商戶網(wǎng)站購買相關(guān)產(chǎn)品或服務(wù)。

1.4業(yè)務(wù)及技術(shù)支持

如果您有任何業(yè)務(wù)及技術(shù)上的疑問,可聯(lián)系省號百技術(shù)人員。

2.業(yè)務(wù)描述及接口開發(fā)

2.1功能說明及流程

WEB網(wǎng)上支付方式是指利用網(wǎng)銀賬戶,通過互聯(lián)網(wǎng)Web網(wǎng)頁操作完成支付過程的方式。

此種方式下,客戶利用PC終端,通過登陸號百或合作方網(wǎng)站,進行商品或服務(wù)選購,生成

并確認訂單信息,根據(jù)本人使用借記卡或貸記卡付款的要求,選擇相應(yīng)銀行通過銀行網(wǎng)銀界

面實現(xiàn)支付的功能。

用戶向交易網(wǎng)站購物時,需要通過一定方式向商戶支付相關(guān)費用。商戶網(wǎng)站系統(tǒng)如果集

成號百網(wǎng)上支付功能,則可以讓用戶安全、方便、快捷地向商戶支付選購商品及服務(wù)款項,

并且商戶也可以很容易了解到款項的到帳情況及用戶購買的產(chǎn)品或服務(wù)。

整體流程如下:

用戶在商戶交易網(wǎng)站選擇產(chǎn)品或服務(wù),在下訂單支付完成后,商戶網(wǎng)站會將該訂單號及

對應(yīng)訂單金額等相關(guān)信息提交到號百,然后跳轉(zhuǎn)到號百頁面進行支付。當支付完成后,號百

將支付結(jié)果返回商戶,并且根據(jù)商戶指定的地址跳轉(zhuǎn)到商戶指定頁面。商戶系統(tǒng)后臺接收到

支付結(jié)果之后,對數(shù)據(jù)庫進行相應(yīng)更新,然后在顯示給用戶的頁面中作出相應(yīng)提示。

2.2商戶接入前提

商戶接入號百平臺網(wǎng)上支付,須準備好指定網(wǎng)站供客戶上網(wǎng)瀏覽,并為用戶提供商

品查詢、選購,直至下單的功能及頁面展示。以下頁面須由商戶預先實現(xiàn)方能進行號百

網(wǎng)上支付接入,參考圖示如下:

網(wǎng)上文材?碼成亍

第一步:選場恁所需要的前品.點擊-去收隙臺“鰭鼻:

e?rM*

w比口T5元X

詢工?。?益:1#£?:1MMil:7S2ZV$97Fr:元

?網(wǎng)上支付》在皿■于

?娘耳收a信嵬第二歲您的個人信息笄痣簿”匯付天下在&支tr方式付事

■正?《片以下收貨值?

收膏人及9W冬:匚H別:*

M&t城:

?R?K:

電*樣:

出身方式:

支助式:

上f|眼下一[

?網(wǎng)上支什,芭收旗寧

??安工■第三步杳?井?認悠的訂?信息,

?&S?序給儻?a(M?BftS:/9£費

㈤!2m?Mas?n?

nireit:wJt

IStflhtV

:o兄

X中越飲:?!?/p>

西me

7S00?

查■送miet-

上f1舞?1

2.3參數(shù)說明

2.3.1HTTP訂單支付請求接口

http訂單支付請求地址:http://www.hbl18114.cn/servicelnterface/do.aspx

接口描述

接口名稱重定向跳轉(zhuǎn)訂單支付請求接口

接口描述通過調(diào)用支付接口向號百平臺發(fā)出支付請求,平臺通過支付Portal與

用戶進行交互,完成支付處理后,重定向回應(yīng)用系統(tǒng)(SP)

接口提供者號百平臺

接口使用者應(yīng)用系統(tǒng)(SP)

接口定義

應(yīng)用系統(tǒng)的請求參數(shù)定義:

字段名稱長度是否說明

必填

BSTMERCHANTIDSP身份標CHAR(30)是由號百平臺統(tǒng)一分配

ORDERSEQ訂單號CHAR(30)是由SP提供,在sp處不能重復,用于標

識一個唯一的訂單,訂單號可以在沒有

支付成功的情況下,再次進行交易,但

每次交易時的訂單請求交易流水號不能

重復

數(shù)字或字母組成

ORDERREQTRANSEQ訂單請求CHAR(30)是訂單支付請求的交易流水號

交易流水每次訂單支付時,不要重復

號以日期時間yyyyMMddHHmmssff+號百平

臺商戶代碼(由號百平臺提供),如:

20061012132425350001

2006101213242535為日期時間

0001為號百給定的商戶代碼

數(shù)字或字母組成

ORDERDATE訂單日期CHAR(8)是由SP提供,長度8

yyyy-MM-dd格式

ORDERAMOUNT訂單總金NUMBER(10)是單位:分

額訂單總金額=產(chǎn)品金額+附加金額

PRODUCTAMOUNT產(chǎn)品金額NUMBER(10)是單位:分

ATTACIIAMOUNT附加金額NUMBER(10)是單位:分

VIEWURL前臺返回CHAR(256)是SP提供的用于接收交易返回的前臺

地址url,不做業(yè)務(wù)處理,僅僅用于前臺頁面

顯示結(jié)果

DEALURL后臺返回CHAR(256)是SP提供的用于接收交易返回的后臺

地址url,用于實際的業(yè)務(wù)處理

USERIDSP用戶IDCHAR(40)是SP平臺用戶ID,為SP平臺用戶體系的

唯一標識。

REMARK備注CHAR(256)是SP平臺提供對本次訂單的描述

如:“充值”或

“購買了一張電影票”

ATTACH附加信息CHAR(50)否SP附加信息

MACMAC校驗域CHAR(256)是采用標準的MD5算法,由SP實現(xiàn)

說明:

1)商戶要保證訂單號的唯一性。

2)在商戶提交訂單的頁面上,提交按鈕應(yīng)該是點擊一次后,馬上不可用,防止用戶多次提

交。

3)接口方式采用表單方式,商戶將以上信息包含在表單中,直接SUBMIT到號百平臺url

4)MAC校驗,保證了交易信息到支付平臺的完整性,參與MAC運算的字符及其順序如下:

BSTMERCHANTID=123456789&0RDERSEQ=20060314000001&ORDERDATE=20060314&ORDERAMOUNT=

10000

將上述固定順序組織的字符串,參數(shù)名均為大寫,使用標準md5算法進行摘要,然后將摘要

果轉(zhuǎn)成16進制字符串,就是校驗域MAC的值,并在提交訂單時,將MAC值和訂單信息一起

提交到號百平臺

號百平臺的響應(yīng)參數(shù)定義:

字段名稱類型是否說明

必填

BSTUPTRANSEQ號百平臺交CHAR(50)是由號百平臺提供,SP必須保存該信

易流水號息,作為對帳依據(jù)

BSTTRANDATE號百平臺交CHAR(8)是由號百平臺提供,SP必須保存該信

易日期息,格式:yyyy-MM-dd,商戶對賬、

清算報表以此日期為準

RETNC0DE處理結(jié)果碼CHAR(4)是由號百平臺統(tǒng)一定義,SP需保存,

作為對帳數(shù)據(jù)。結(jié)果碼為“0000”表

示支付成功,其他值則表示支付失敗

RETNINFO處理結(jié)果解CHAR(10)是由號百平臺統(tǒng)一定義,對支付結(jié)果的

釋碼說明碼

ORDERREQTRANSEQ訂單請求交CHAR(32)是從SP發(fā)送的訂單的信息中獲得

易流水號,號百平臺原值傳回

ORDERSEQ訂單號CHAR(32)是從SP發(fā)送的訂單的信息中獲得

,號百平臺原值傳回

ORDERAMOUNT訂單總金額NUMBER(10)是從SP發(fā)送的訂單的信息中獲得

,號百平臺原值傳回,單位:分

訂單總金額=產(chǎn)品金額+附加金額

PRODUCTAMOUNT產(chǎn)品金額NUMBER(10)是從SP發(fā)送的訂單的信息中獲得

,號百平臺原值傳回,單位:分

ATTACHAMOUNT附加金額NUMBER(10)是從SP發(fā)送的訂單的信息中獲得

,號百平臺原值傳回,單位:分

USERIDSP用戶IDCHAR(40)是SP平臺用戶ID,為SP平臺用戶體系

的唯一標識。號百平臺原值傳回

ATTACHSP附加信息CHAR(32)否從SP發(fā)送的訂單的信息中獲得

,號百平臺原值傳回

SIGN數(shù)字簽名CHAR(256)是數(shù)字簽名算法由號百平臺統(tǒng)一提供,

作為核查依據(jù)

說明:

1、商戶提供的后臺url,號百平臺是以post方式將支付結(jié)果提交到該url上

2、商戶平臺在收到后臺支付結(jié)果后,請直接在應(yīng)答時寫入格式為UPTRANSEQ_XXXXXX的

字符串,其中UPTRANSEQ_為固定寫死,XXXXXX為號百平臺發(fā)送過去的號百平臺交易

流水號

3、號百平臺,如果在60秒鐘沒有收到應(yīng)答,則會重復發(fā)送,重復次數(shù)是3次,如果還沒

有應(yīng)答會每隔半小時發(fā)送一次截止到第二天凌晨。

4、號百平臺如果收到應(yīng)答,則不再發(fā)送支付結(jié)果。

5、當商戶收到號百平臺發(fā)回來的支付結(jié)果信息后,獲取支付結(jié)果和簽名的信息,然后對數(shù)

字簽名進行校驗,步驟如下:

1)商戶將支付結(jié)果的明文和密鑰組成一個固定順序的串,如下:

BSTUPTRANSEQ=20080101000001&BSTMERCHANTID=0250000001&ORDERSEQ=2006050

112564931556&ORDERAMOUNT=10000&RETNCODE=0000&RETNINFO=0000&BSTTR

ANDATE=200601()1&KEY=123456

串的順序不能改變,參數(shù)名一定要用大寫;

KEY的值由號百平臺統(tǒng)一提供。

2)將1)獲得的結(jié)果使用標準的MD5算法運算,再將運算結(jié)果轉(zhuǎn)成16進制字符串;

3)將2)獲得值和SIGN值進行比較,如一致則數(shù)字簽名正確,說明信息沒有被篡改。

2.3.2退款接口

Webservices接口地址:http://ww.xxxx.com/services

方法名:Stringrefund()

號百支付平臺對調(diào)用該接口的服務(wù)器地址進行綁定,在聯(lián)調(diào)前,請?zhí)峁┓?wù)器地址。

請求入?yún)⒄f明:

參數(shù)含義類型長度必填備注

commCode商戶代碼xsd:string20是由號百平臺統(tǒng)一分配給

各接入商戶

subCommCode商戶子代碼xsd:string30否商戶子代碼

如沒有則填空

commPwd商戶調(diào)用密碼xsd:string20是商戶執(zhí)行時需填入相應(yīng)

密碼

oldOrderld原扣款訂單號xsd:string30是原扣款成功的訂單號

oldOrderPayld原訂單請求支xsd:string30是原訂單請求支付流水號

付流水號

orderRefundld退款流水號xsd:string30是該流水在商戶處必須是

唯一的,而且每次發(fā)起支

付或退款時,都必須是唯

一的

transamt訂單交易金額xsd:string12是單位為元

如2.00

reqTime交易請求時間xsd:string14是YYYYMMDDHHMMSS

macMac校驗域xsd:string32是md5摘要

為什么支付時交易金額單位是分,而在退款時時以元為單位?能否統(tǒng)一?

方法返回參數(shù)

類型長度必填備注

xsd:String20是具體見出參類型說明

返回成功即表示退款成功

說明:

1)商戶要保證退款流水號的唯一性。

2)在商戶提交退款時,防止多次提交同一筆退款。

3)接口方式采用webservices方式,key由號百支付平臺分配給各商戶。

4)MAC校驗,保證了交易信息到支付平臺的完整性,參與MAC運算的字符及其順序如下:

COMMCODE=123456789&COMMPWD=123456&ORDERREFUND1D=20080314000001&REQTIME=20080314

&TRANSAMT=10000&KEY=DJKF34ER35D58D

商戶平臺將上述固定順序組織的字符串,參數(shù)名均為大寫,使用標準md5算法進行摘要,然

后將摘要果轉(zhuǎn)成16進制字符串,就是校驗域MAC的值,將MAC值和訂單信息調(diào)用接口時,

一起提供給號百支付平臺

附:

MD5算法的.net實現(xiàn):

///<summary>

///MD5加”?密”

Ill</summary>

///<param一―二1仃二加“密"1字A?符。?</p

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責。
  • 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論