澳門通（MPay）

一臉懵逼

因?yàn)樵诎拈T通集成過程中幾經(jīng)波折，也碰到過些坑市咆，在完成之后汉操，回頭發(fā)現(xiàn)本來很簡(jiǎn)單的事情，因?yàn)椴皇煜っ衫迹约霸谂c澳方溝通過程花費(fèi)了大量時(shí)間磷瘤，所以將自己的血淚歷程與MPay集成方法，以及碰到的坑搜变，分享給大家采缚，希望大家在開發(fā)過程中能節(jié)省點(diǎn)寶貴的時(shí)間及少趟點(diǎn)坑，權(quán)當(dāng)拋磚引玉挠他。

MPay 在打包靜態(tài)庫的時(shí)候殖侵，已經(jīng)將 微信 打包進(jìn)了SDK贸呢，所以如果項(xiàng)目在調(diào)用 微信 的時(shí)候，只能使用 MPay內(nèi)部集成的 微信 支付拢军，如果外界想要單獨(dú)調(diào)用 微信支付的時(shí)候楞陷，在導(dǎo)入 微信 SDK的時(shí)候，就會(huì)報(bào) 重復(fù)導(dǎo)入 的錯(cuò)誤茉唉。這是一個(gè)坑固蛾，要留意一下！

所以度陆，以下分為三個(gè)步驟來說明 MPAy 支付艾凯，MPay調(diào)用 支付寶 ，MPay調(diào)用微信 懂傀。

澳門通與商戶之間通過交換報(bào)文與資料檔案來交換業(yè)務(wù)資訊览芳、實(shí)現(xiàn)業(yè)務(wù)流程、控制業(yè)務(wù)規(guī)則鸿竖。雙方的交互模式可以歸納為請(qǐng)求-應(yīng)答沧竟、單向通知、文檔上傳與文檔下載這四種模式缚忧，實(shí)際業(yè)務(wù)中可能會(huì)將各種交互模式結(jié)合起來使用悟泵。下文將介紹這四種交互模式適用的場(chǎng)景與實(shí)現(xiàn)方式。

1闪水、請(qǐng)求(Request)-應(yīng)答(Response)模式:

在請(qǐng)求-應(yīng)答模式下糕非，一方作為服務(wù)提供者，另一方作為服務(wù)使用者。由服 務(wù)使用者主動(dòng)向服務(wù)提供者發(fā)起請(qǐng)求并等待應(yīng)答朽肥，服務(wù)提供者接受請(qǐng)求禁筏，完成 處理，并向服務(wù)使用者應(yīng)答處理結(jié)果衡招，服務(wù)使用者收到處理結(jié)果之后進(jìn)行后續(xù) 處理篱昔。

請(qǐng)求-應(yīng)答模式適用于服務(wù)使用者需要根據(jù)服務(wù)提供者的服務(wù)應(yīng)答才能進(jìn)行 正確的后續(xù)處理的場(chǎng)景。 本文中始腾，服務(wù)使用者指商戶的系統(tǒng)設(shè)施及服務(wù)州刽，服務(wù)提供者指澳門通及其相應(yīng) 的系統(tǒng)設(shè)施及服務(wù)。

請(qǐng)求(Request)-應(yīng)答(Response)模式

2浪箭、單向通知模式:

在單向通知模式下穗椅，一方作為通知發(fā)送者，一方作為通知接收者奶栖。發(fā)送者發(fā)送通知匹表，并保證接收者收到通知。通知接收者在收到通知之后宣鄙，立即返回發(fā)送者通知已收到袍镀。通知送達(dá)之后，發(fā)送方與接收方可以獨(dú)立地進(jìn)行后續(xù)業(yè)務(wù)處理框冀。如果對(duì)方進(jìn)行業(yè)務(wù)處理所需的時(shí)間不可預(yù)知時(shí)，采用單向通知模式敏簿。單向通知模式可以單獨(dú)使用明也，也可以作為其它交互模式的一部分使用，因此惯裕，單向模式適用于澳門通主動(dòng)通知商戶交易處理成功温数。

單向通知模式

一：MPaySDK支付集成流程

1：由MPay iOS端提供的 MPaySDK.framework靜態(tài)庫引入到工程項(xiàng)目中（目前不支持Cocopods）；

MPaySDK.framework

在需要支付的類中導(dǎo)入 #import <MPaySDK/MPaySDK.h> 文件路徑

2：Command+B 編譯一下蜻势，報(bào)錯(cuò)導(dǎo)入以下類：

libsqlite3.tbd

libc++.tbd

libz.tbd

libc.tbd

CoreMotion.framework

CFNetwork.framework

SystemConfiguration.framework

CoreTelephony.framework

QuartzCore.framework

CoreText.framework

CoreGraphics.framework

Foundation.framework

UIKit.framework

編譯撑刺，完美通過

3：Target - info -URL Types 配置URL Types 設(shè)置自己項(xiàng)目的URL Schems,以便調(diào)用SDK方法的時(shí)候使用

URL Schemes

因?yàn)閁AT測(cè)試環(huán)境，生產(chǎn)環(huán)境服務(wù)器的https應(yīng)用層不
支持ATS設(shè)置握玛，如果應(yīng)用程式基于9.0編譯够傍，由于iOS9.0中https應(yīng)用程序傳輸安全（ATS）的限制，我們需要設(shè)置：NSAppTransportSecurity 的 Allow Arbitrary Loads 為 YES

4挠铲、支付環(huán)境設(shè)置

在MPaySDK.h文件中可以查看環(huán)境變量的枚舉值

0：MPay_SIT 代表MPay SIT 環(huán)境

1: MPay_UAT 代表MPay UAT環(huán)境

2:MPay_Prod 代表MPay 生產(chǎn)環(huán)境

通過實(shí)例方法進(jìn)行UAT環(huán)境配置
例:[[MPaySDKsharedInstance] setEnvironmentType:MPay_UAT];

5冕屯、支付方法調(diào)用

/**
 商戶使用(MPay)
 
 @param params 商戶簽名后的訂單數(shù)據(jù)
 @param schema 商戶APP的url schema
 @param sender  當(dāng)前控制器
 @param delegate 實(shí)現(xiàn)協(xié)議方法的代理對(duì)象
 */
-(void)MPayWithParams:(NSDictionary *)params withSchema:(NSString *)schema WithSender:(id)sender withDelegate:(id<MPaySDKDelegate>)delegate;

6、params 參數(shù)說明

● biz_content 說明

7暮蹂、方法具體實(shí)現(xiàn)：

//簽名地址    - 要改成貴公司服務(wù)器 api 地址

NSString*signUrl =  @"xxxx";

//簽完名之后拿到服務(wù)器返回的NSDictionary類型數(shù)據(jù)寞缝，作為參數(shù)

//調(diào)起支付

        if(params) {

            [[MPaySDK sharedInstance]MPayWithParams:params withSchema:@"macaupayF2823" WithSender:self withDelegate:self];

        }

8、在響應(yīng)事件 控制器中遵循代理協(xié)議

@interface ViewController ()<MPaySDKDelegate>

實(shí)現(xiàn)代理方法
//實(shí)現(xiàn)支付完成或者取消之后的回調(diào)結(jié)果（注意兼容ios8的方法）
//在需要處理結(jié)果的地方實(shí)現(xiàn)MPaySDKDelegate協(xié)議方法 處理展示結(jié)果邏輯

/**

 支付成功回調(diào)

@paramstatus 支付狀態(tài)標(biāo)誌 true成功 false 失敗

@paramorder 訂單信息

 */

-(void)MPaySDK_WithPayStatus:(bool)status WithOrder:(NSDictionary*)order;

/**

 支付失敗回調(diào)

@paramerrorInfo 錯(cuò)誤信息

@paramerrorCode 錯(cuò)誤碼

 */

-(void)MPaySDK_WithFailed:(NSString*)errorInfo withErrorCode:(NSString*)errorCode;

9仰泻、支付回調(diào)及響應(yīng)狀態(tài)

在項(xiàng)目AppDelegate.m里面的回調(diào)方法

-(BOOL)application:(UIApplication*)app openURL:(NSURL*)url options:(NSDictionary *)options{

   //里面調(diào)用

    [[MPaySDK sharedInstance]ProcessOrderWithPaymentResult:url];

    return true;

}

-(BOOL)application:(UIApplication*)application openURL:(NSURL*)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation

{

    //回調(diào)方法第租，必調(diào)

    [[MPaySDK sharedInstance] ProcessOrderWithPaymentResult:url];

    return true;

}

10、支付狀態(tài)碼

二：AliPaySDK支付集成流程

AliPay 和 MPay 前期配置相同我纪，導(dǎo)入MPaySDK.framework靜態(tài)庫慎宾，并且需要導(dǎo)入AliPaySDK 包文件丐吓，只不過支付方法和 上傳參數(shù)，這里只說明有區(qū)別的點(diǎn)趟据，其它參考 上面 MPay券犁，AliPaySDK支付狀態(tài)碼參考同MPaySDK支付狀態(tài)碼

1、支付方法調(diào)用

  /**

      商戶使用(支付寶)

      @paramparams 商戶簽名后的訂單數(shù)據(jù)

      @paramScheme 商戶APP的url schema

      @paramdelegate 實(shí)現(xiàn)協(xié)議方法的代理對(duì)象

      */
-(void)AliPayWithParams:(NSDictionary*)params withScheme:(NSString*)Scheme with:(id)delegate;

2汹碱、params參數(shù)說明

● biz_content 說明
參考macauPay的參數(shù)說明

3冲茸、方法具體實(shí)現(xiàn)：

//a屯阀、簽名地址    - 要改成貴公司服務(wù)器 api 地址

NSString*signUrl =  @"xxxx";

//b、簽完名之后拿到服務(wù)器返回的NSDictionary類型數(shù)據(jù)轴术，作為參數(shù)

//調(diào)起支付

        if(params) {

            [[MPaySDK sharedInstance] AliPayWithParams:params withScheme:@"macaupayF2823" with:self];

        }

三：WechatPaySDK支付集成流程

由MPay iOS端提供的sdk文件难衰，MPaySDK.framework 靜態(tài)庫引用到工程項(xiàng)目中(如果已經(jīng)引入，無需重復(fù)引入)：并且需要導(dǎo)入WechatPay支付所需要的文件和靜態(tài)庫：libWeChatSDK.a, WechatAuthSDK.h, WXApi.h, WXApiObject.當(dāng)已經(jīng)再開放平臺(tái)已經(jīng)注冊(cè)應(yīng)用并且報(bào)備之后逗栽，再項(xiàng)目工程里面的AppDelegate.h文件中導(dǎo)入的WXApi.h 盖袭，并且在didFinishLaunchingWithOptions 方法中向微信發(fā)起注冊(cè)：

例：[WXApi registerApp:@"xxxx" enableMTA:NO];

在需要支付的類中導(dǎo)入MPaySDK.h文件路徑即可。

1彼宠、支付方法調(diào)用

/**

 商戶使用(微信)

 @paramparams 商戶簽名后的訂單數(shù)據(jù)

 @paramScheme 商戶APP在開放平臺(tái)註冊(cè)的appid

 @paramdelegate 實(shí)現(xiàn)協(xié)議方法的代理對(duì)象

 */

-(void)WeChatPayWithParams:(NSDictionary*)params withScheme:(NSString*)Scheme with:(id)delegate;

2鳄虱、params參數(shù)說明

3、方法具體實(shí)現(xiàn)：

//a兵志、簽名地址    - 要改成貴公司服務(wù)器 api 地址

NSString*signUrl =  @"xxxx";

//b醇蝴、簽完名之后拿到服務(wù)器返回的NSDictionary類型數(shù)據(jù)宣肚，作為參數(shù)

//調(diào)起支付

        if(params) {

            [[MPaySDK sharedInstance] WeChatPayWithParams:params withScheme:@"macaupayF2823" with:self];

        }

4想罕、支付回調(diào)及響應(yīng)狀態(tài)

參考同MPaySDK支付回調(diào)及響應(yīng)狀態(tài)

5、支付狀態(tài)碼

以上就是 MPay iOS端集成的全部過程楼镐，如有疑問歡迎留言指正。??