澳门通（MPay）

一脸懵逼

因为在澳门通集成过程中几经波折，也碰到过些坑，在完成之后，回头发现本来很简单的事情，因为不熟悉，以及在与澳方沟通过程花费了大量时间，所以将自己的血泪历程与MPay集成方法，以及碰到的坑，分享给大家，希望大家在开发过程中能节省点宝贵的时间及少趟点坑，权当抛砖引玉。

MPay 在打包静态库的时候，已经将 微信 打包进了SDK，所以如果项目在调用 微信 的时候，只能使用 MPay内部集成的 微信 支付，如果外界想要单独调用 微信支付的时候，在导入 微信 SDK的时候，就会报 重复导入 的错误。这是一个坑，要留意一下！

所以，以下分为三个步骤来说明 MPAy 支付，MPay调用 支付宝 ，MPay调用微信 。

澳门通与商户之间通过交换报文与资料档案来交换业务资讯、实现业务流程、控制业务规则。双方的交互模式可以归纳为请求-应答、单向通知、文档上传与文档下载这四种模式，实际业务中可能会将各种交互模式结合起来使用。下文将介绍这四种交互模式适用的场景与实现方式。

1、请求(Request)-应答(Response)模式:

在请求-应答模式下，一方作为服务提供者，另一方作为服务使用者。由服 务使用者主动向服务提供者发起请求并等待应答，服务提供者接受请求，完成 处理，并向服务使用者应答处理结果，服务使用者收到处理结果之后进行后续 处理。

请求-应答模式适用于服务使用者需要根据服务提供者的服务应答才能进行 正确的后续处理的场景。 本文中，服务使用者指商户的系统设施及服务，服务提供者指澳门通及其相应 的系统设施及服务。

请求(Request)-应答(Response)模式

2、单向通知模式:

在单向通知模式下，一方作为通知发送者，一方作为通知接收者。发送者发送通知，并保证接收者收到通知。通知接收者在收到通知之后，立即返回发送者通知已收到。通知送达之后，发送方与接收方可以独立地进行后续业务处理。如果对方进行业务处理所需的时间不可预知时，采用单向通知模式。单向通知模式可以单独使用，也可以作为其它交互模式的一部分使用，因此，单向模式适用于澳门通主动通知商户交易处理成功。

单向通知模式

一：MPaySDK支付集成流程

1：由MPay iOS端提供的 MPaySDK.framework静态库引入到工程项目中（目前不支持Cocopods）；

MPaySDK.framework

在需要支付的类中导入 #import <MPaySDK/MPaySDK.h> 文件路径

2：Command+B 编译一下，报错导入以下类：

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 设置自己项目的URL Schems,以便调用SDK方法的时候使用

URL Schemes

因为UAT测试环境，生产环境服务器的https应用层不
支持ATS设置，如果应用程式基于9.0编译，由于iOS9.0中https应用程序传输安全（ATS）的限制，我们需要设置：NSAppTransportSecurity 的 Allow Arbitrary Loads 为 YES

4、支付环境设置

在MPaySDK.h文件中可以查看环境变量的枚举值

0：MPay_SIT 代表MPay SIT 环境

1: MPay_UAT 代表MPay UAT环境

2:MPay_Prod 代表MPay 生产环境

通过实例方法进行UAT环境配置
例:[[MPaySDKsharedInstance] setEnvironmentType:MPay_UAT];

5、支付方法调用

/**
 商戶使用(MPay)
 
 @param params 商戶簽名后的订單數據
 @param schema 商戶APP的url schema
 @param sender  當前控制器
 @param delegate 實現協議方法的代理對象
 */
-(void)MPayWithParams:(NSDictionary *)params withSchema:(NSString *)schema WithSender:(id)sender withDelegate:(id<MPaySDKDelegate>)delegate;

6、params 参数说明

● biz_content 说明

7、方法具体实现：

//签名地址    - 要改成贵公司服务器 api 地址

NSString*signUrl =  @"xxxx";

//签完名之后拿到服务器返回的NSDictionary类型数据，作为参数

//調起支付

        if(params) {

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

        }

8、在响应事件 控制器中遵循代理协议

@interface ViewController ()<MPaySDKDelegate>

实现代理方法
//实现支付完成或者取消之后的回调结果（注意兼容ios8的方法）
//在需要处理结果的地方实现MPaySDKDelegate协议方法 处理展示结果逻辑

/**

 支付成功回调

@paramstatus 支付狀態標誌 true成功 false 失敗

@paramorder 訂單信息

 */

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

/**

 支付失败回调

@paramerrorInfo 錯誤信息

@paramerrorCode 錯誤碼

 */

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

9、支付回调及响应状态

在项目AppDelegate.m里面的回调方法

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

   //里面调用

    [[MPaySDK sharedInstance]ProcessOrderWithPaymentResult:url];

    return true;

}

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

{

    //回调方法，必調

    [[MPaySDK sharedInstance] ProcessOrderWithPaymentResult:url];

    return true;

}

10、支付状态码

二：AliPaySDK支付集成流程

AliPay 和 MPay 前期配置相同，导入MPaySDK.framework静态库，并且需要导入AliPaySDK 包文件，只不过支付方法和 上传参数，这里只说明有区别的点，其它参考 上面 MPay，AliPaySDK支付状态码参考同MPaySDK支付状态码

1、支付方法调用

  /**

      商户使用(支付宝)

      @paramparams 商戶簽名后的訂單數據

      @paramScheme 商戶APP的url schema

      @paramdelegate 實現協議方法的代理對象

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

2、params参数说明

● biz_content 说明
参考macauPay的参数说明

3、方法具体实现：

//a、签名地址    - 要改成贵公司服务器 api 地址

NSString*signUrl =  @"xxxx";

//b、签完名之后拿到服务器返回的NSDictionary类型数据，作为参数

//調起支付

        if(params) {

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

        }

三：WechatPaySDK支付集成流程

由MPay iOS端提供的sdk文件，MPaySDK.framework 静态库引用到工程项目中(如果已经引入，无需重复引入)：并且需要导入WechatPay支付所需要的文件和静态库：libWeChatSDK.a, WechatAuthSDK.h, WXApi.h, WXApiObject.当已经再开放平台已经注册应用并且报备之后，再项目工程里面的AppDelegate.h文件中导入的WXApi.h ，并且在didFinishLaunchingWithOptions 方法中向微信发起注册：

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

在需要支付的类中导入MPaySDK.h文件路径即可。

1、支付方法调用

/**

 商户使用(微信)

 @paramparams 商戶簽名后的訂單數據

 @paramScheme 商戶APP在開放平台註冊的appid

 @paramdelegate 實現協議方法的代理對象

 */

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

2、params参数说明

3、方法具体实现：

//a、签名地址    - 要改成贵公司服务器 api 地址

NSString*signUrl =  @"xxxx";

//b、签完名之后拿到服务器返回的NSDictionary类型数据，作为参数

//調起支付

        if(params) {

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

        }

4、支付回调及响应状态

参考同MPaySDK支付回调及响应状态

5、支付状态码

以上就是 MPay iOS端集成的全部过程，如有疑问欢迎留言指正。😀