手機支付系統商戶介面說明書1.0.1(標準版)
2023年3月
1介面定義
1.1 商戶呼叫介面
1.1.1介面模式
介面以包的形式提供,商戶系統需要呼叫這些介面完成交易。包發布時約定乙個商戶介面版本號。這一期以商戶介面版本向下相容為主,即根據商戶請求的版本號查詢對應的處理功能碼,並按對應的版本號返回交易資訊。
後期考慮增加當前版本號查詢和版本自動更新功能。
1.1.2介面描述
(1)web直接支付請求:商戶呼叫這個方法得到直接支付請求去支付閘道器的url。
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、銀行**、有效期單位、有限期資料、結果頁面通知url、結果後台通知url、發票標誌、送貨標誌、保留字段、ip位址;
返回:乙個hashmap物件,包含:定單號、定單日期、url;
(2)線下直接支付請求:商戶呼叫這個方法得到直接支付請求去支付閘道器的url。
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、有效期單位、有限期資料、結果後台通知url、保留字段;
返回:乙個hashmap物件,包含:定單號、定單日期、url;
(3)支付結果返回:商戶呼叫這個方法得到直接支付的結果。
引數:商戶收到的報文;
返回:乙個hashmap物件,包含:定單號、定單日期、支付狀態、錯誤碼、支付金額、支付時間、支付流水號、發票抬頭、收貨人名稱、收貨人位址、郵編、聯絡人**、聯絡人手機。
(4)web預授權請求:商戶呼叫這個方法得到預授權請求去支付閘道器的url。
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、銀行**、有效期單位、有限期資料、結果頁面通知url、結果後台通知url、發票標誌、送貨標誌、保留字段、ip位址;
返回:乙個hashmap物件,包含:定單號、定單日期、url;
(5)線下預授權請求:商戶呼叫這個方法得到預授權請求去支付閘道器的url。
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、有效期單位、有限期資料、結果後台通知url、保留字段;
返回:乙個hashmap物件,包含:定單號、定單日期、url;
(6)預授權結果返回:商戶呼叫這個方法得到預授權的結果。
引數:商戶收到的報文;
返回:乙個hashmap物件,包含:定單號、定單日期、預授權狀態、錯誤碼、預授權金額、交易時間、預授權碼、發票抬頭、收貨人名稱、收貨人位址、郵編、聯絡人**、聯絡人手機。
(7)預授權確認:商戶呼叫這個方法確認預授權;
引數:定單號、定單日期、預授權碼、預授權金額;
返回:錯誤碼。
(8)預授權取消:商戶呼叫這個方法取消預授權;
引數:定單號、定單日期、預授權碼、預授權金額;
返回:錯誤碼。
(9)後台交易通知:商戶啟動乙個servlet,偵聽來自ipos的後台交易結果通知。
引數:商戶收到的報文;
返回:乙個hashmap物件,包含:定單號、定單日期、支付狀態、錯誤碼、支付金額、支付時間、支付流水號、發票抬頭、收貨人名稱、收貨人位址、郵編、聯絡人**、聯絡人手機。
(10)定單查詢:商戶呼叫這個方法查詢定單的狀態。
引數:定單號、定單日期;
返回:乙個hashmap物件,包含:定單號、定單日期、支付狀態、錯誤碼、支付金額、支付時間、支付流水號、發票抬頭、收貨人名稱、收貨人位址、郵編、聯絡人**、聯絡人手機。
(11)退款:商戶呼叫這個方法發起退款。
引數:定單號、定單日期、交易金額、退款金額;
返回:錯誤碼。
(12)獲取支付請求令牌:商戶呼叫這個介面時,系統通過通訊給ipos傳送乙個(1)的報文,
ipos處理完這個交易,返回給乙個sessionid;
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、銀行**、有效期單位、有限期資料、結果頁面通知url、結果後台通知url、發票標誌、送貨標誌、保留字段、ip位址;
返回:sessionid;
(13)獲取預授權請求令牌:商戶呼叫這個介面時,系統通過通訊給ipos傳送乙個(4)的報文,ipos處理完這個交易,返回給乙個sessionid;
引數:定單號、定單日期、商品名稱、商品編碼、商品描述、貨幣**、**、銀行**、有效期單位、有限期資料、結果頁面通知url、結果後台通知url、發票標誌、送貨標誌、保留字段、ip位址;
返回:sessionid;
(14)帳戶變動通知:商戶啟動乙個servlet,偵聽來自ipos的帳戶變動通知。
引數:報文;
返回:變動型別、商戶訂單號、訂單金額、訂單日期。
1.1.3ipos-m和ipos通訊介面
1.1.3.1 介面模式
用https保證通訊鏈路的安全,用數字簽名保證交易不被篡改。將整個串做一次加密保證資料不被竊取。根據交易型別的不同,介面分為兩種:頁面跳轉和後台通訊。
1.1.3.1.1頁面跳轉模式
頁面跳轉模式用於需要使用者互動的交易。
(1)令牌頁面跳**商戶系統根據報文格式組好資料報後通過後台通訊向ipos-s發起請求,ipos-s返回乙個令牌;商戶系統再根據這個令牌組織重定向url,重定
向到ipos-s系統。
1.1.3.1.2後台通訊模式
後台通訊模式用於不需要使用者互動的交易,比如線下直接支付、訂單查詢、退款等。商戶系統根據報文組好資料報後向ipos-s發起請求,ipos-s返回結果報文。
1.1.3.2 簽名演算法
簽名源串:報文頭的值按文件順序相加,再加上報文體的字段值按順序相加;其中,hmac、merchantcert、servercert欄位不參與簽名。
1.1.3.3 重定向url
約定ipos-s的url位址是
(1)令牌跳**
首先,商戶伺服器和支付系統伺服器做一次互動,由商戶系統給支付平台提交一次訂單登記請求;支付平台返回乙個令牌,商戶系統再組織乙個web表單,如下:這裡dddd就商戶系統得到的令牌。
1.1.3.4 後台通訊url
(2)後台通訊獲取token的url
(3)後台下單和業務處理的url
1.1.4商戶介面1.1.4.1 報文頭
報文格式錯誤的標準返回報文:
對一筆訂單可以多次操作的,在業務引數裡面一定要加上請求號(requestid),如:退款、預授權確認等
1.1.4.2 業務型別定義
直接支付:dodirect payment
b2c擔保交易:b2c-doguarantee
c2c擔保交易:c2c-doguarantee
預授權:do ahtorization
預授權確認:do capture
預授權取消:dovoid
訂單查詢:ordersearch
退款:orderrefund
後台交易通知:根據交易型別填寫。
1.1.4.3 介面內容
1.1.4.3.1獲取直接支付令牌請求資料要素:
返回資料要素:
1.1.4.3.2頁面支付結果通知
1.1.4.3.3後台下單請求資料要素:
1.1.4.3.4定單查詢
返回資料要素:
1.1.4.3.5預授權確認
1.1.4.3.6預授權取消請求資料要素:
返回資料要素:
1.1.4.3.7退款
請求資料要素:
報文頭中的requestid代表一次退款請求,防止重複提交,最好跟訂單中的商品編碼關聯起來。
當日退款相當於撤銷,如果返回success表示撤銷成功,使用者款項實時退回。
返回資料要素:
1.1.4.3.8後台交易通知
直接支付、傳統預授權、b2c擔保交易、c2c擔保交易當使用者確認支付之後,除了頁面的支付結果通知以外,還有乙個後台的支付結果通知。
返回資料要素:
1.1.4.3.9後台預授權確認通知
傳統預授權、b2c擔保交易、c2c擔保交易支付確認後,當使用者或者商戶通過登入商戶(使用者)系統發起對交易的確認時,由支付平台發起這樣乙個通知,通知的位址就是報文頭里的notifyurl。
返回資料:無。
注意:在http通訊層面上需要返回乙個字串來證明該請求已經被商戶系統正確接收了。
1.1.4.3.10後台預授權取消通知
傳統預授權、b2c擔保交易、c2c擔保交易支付確認後,當使用者或者商戶通過登入商戶系統發起對交易的取消時,由支付平台發起這樣乙個通知,通知的位址就是報文頭里的notifyurl。
返回資料:無。
注意:在http通訊層面上需要返回乙個字串來證明該請求已經被商戶系統正確接收了。
1.1.4.3.11後台退款通知
交易完成後,當商戶通過登入商戶系統發起對交易的退款時,由支付平台發起這樣乙個通知,通知的位址就是報文頭里的notifyurl。
請求資料要素:
返回資料:無。
注意:在http通訊層面上需要返回乙個字串來證明該請求已經被商戶系統正確接收了。
手機支付營銷活動方案
為快速推進手機支付業務的健康發展,培養客戶使用手機支付業務的習慣,為公司的客戶穩定奠定堅實的基礎,給客戶提供差異化的服務內容和優惠政策,擬決定在全市範圍內開展手機支付營銷活動,現將活動的具體內容匯報如下,請領導批示。一 活動時間 2012年3月20日至2012年5月底 二 活動主題 手機繳費送驚喜 ...
支付系統宣傳總結
為進一步提高金融服務水平,努力構建和諧支付環境,更好地滿足金融市場發展要求,鞏固央行支付在社會公眾心目中的地位,深入推進 金融知識進社群 活動開展,2012年6月16日,漯河市中心支行組織轄區各銀行業金融機構隆重舉行支付系統宣傳現場活動,將漯河市2012年現代化支付系統宣傳工作推向高潮。一 高度重視...
支付系統風控方案
預設 系統預設的風控限制 商戶 系統對商戶的風控限制 支付方式 系統對支付方式的風控限制 ip 系統對ip的風控限制 系統可以設定除缺省外 商戶 支付方式 ip的任意組合限制商戶可以在系統預設規則 組合規則內自配限制策略。比如 系統給商戶限制單筆金額 5000元,商戶可以自配,5000元一下任意單筆...