YHICBCPaySDK 1.1.0

YHICBCPaySDK 1.1.0

×

由 yhkj 维护。

 
依赖
AlipaySDK-iOS>= 0
WechatOpenSDK>= 0
AFNetworking~> 4.0
Toast~> 4.0.0
 

YHICBCPaySDK 1.1.0

  • 作者
  • XmYhkj

ICBCPaySDK

工行e支付

iOS工行支付SDK使用文档

最后修改日期：2021/10/09 商户必须更新到AFN4.0版本！！！

1、场景介绍

商家APP调用工商银行软件开发生成的SDK调用客户端内的支付模块，如果用户安装了工商银行App，商家APP会跳转到App内完成支付，支付完成后会跳转回商家APP并展示支付结果。如果用户没有安装工商银行App，会在SDK内启动支付页面进行支付，支付完成后，将跳转回商家界面。

2、快速接入

2.1 接入ICBCPaySDK的静态库ICBCPaySDK.framework及资源包ICBCPaySDK.bundle，如下图所示。

如果有多个target的工程，请检查build Phases相关文件是否成功引入。

2.2、接入工程所需的第三方组件。AFN网络请求框架、toast组件。具体如下图所示。

具体地址如下可参照下表。 网络请求框架 AFNetWorkworking 4.0版本 地址：https://github.com/AFNetworking/AFNetworking/ toast组件 uiview+toast.view：地址：https://github.com/scalessec/Toast 其中：AFNetworkorking使用的是4.0版本，可以在README.md中查看

查看版本号方法：

3、代码示例

3.1 引入 ICBCPaySDK.h 文件，创建应用单例。

   #import  < ICBCPaySDK/ ICBCPaySDK.h>
       ICBCPaySDK *shareSDK = [ICBCPaySDK sharedSdk];
       shareSDK.sdkDelegate = self;
      shareSDK.urlListMain =   @https://b2c.icbc.com.cn 请务必配置此生产地址（支付平台地址）

注意：以上两个地址，在测试阶段应该配置模测环境地址，以便报错后查找日志。

3.2 传入支持参数，弹出支付页面

（1）interfaceName 接口名 （2）interfaceVersion 接口版本号 （3）tranData 交易信息 （4）merSignMsg 交易信息签名 （5）merCert 商户公钥文件信息 （6）urlScheme 应用包名，必须传入，否则跳转至工行 App 无法返回。

    NSMutableDictionary *testDic = [[NSMutableDictionary alloc] init];
    testDic[@"urlScheme"] = urlScheme;
    testDic[@"interfaceName"] =interfaceName;
    testDic[@"interfaceVersion"] = interfaceVersion;
    testDic[@"tranData"] = tranData;
    testDic[@"merSignMsg"] = merSignMsg;
    testDic[@"merCert"] = merCert;
    [shareSDK presentICBCPaySDKInViewController:self  andTraderInfo:testDic];

    //传入的self，为弹出支付页面的viewcontroller。SDK会对traderInfo的字段进行检查，发现字段为空，导致交易无法进行会进行toast提示。

3.3 代理结果回调

支付完成或者失败时，会回调此方法，商户端可根据返回的信息自行处理。

     - (void)paymentEndwithResultDic:(NSDictionary*)dic｛

            NSLog(@"pass the pkpaymentAuthorizationstatus to the page");
                 [self.view makeToast:@“支付成功，商户端自行处理"];
      ｝

 字典如下格式如下：
   tranCode:交易结果代码
   tranMsg:交易结果信息
   orderNo：订单号

3.4 如果跳转至工行 App 支付，需要在 AppDelegate.m 中添加如下实现。

iOS 9.0 以下版本，请实现如下方法

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

    if ([[url absoluteString] hasSuffix:@"ICBCB2CPAY"]) {
        [[ICBCPaySDK sharedSdk] ICBCResultBackWithUrl:url];
         }
           
     return YES;
}

iOS 9.0 以上版本请实现如下方法。

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:    (NSDictionary<NSString*, id> *)options{
           
        if ([[url absoluteString] hasSuffix:@"ICBCB2CPAY"]) {
            [[ICBCPaySDK sharedSdk] ICBCResultBackWithUrl:url];
        }
    
        return YES;
}

3.5 项目设置 urlscheme

在 Xcode 中打开项目，设置项目属性中的 URL Schemes 为子商户的应用包名。如图所示。（此处配置需要与上面传入的保持一致）

####   3.6 tranCode 对应关系

tranCode 与 tranMsg 的对应关系： 1--交易成功，已清算 2--交易失败 3--交易可疑 4--用户中止交易

4、注意事项

4.1 SDK支付有两种模式：如果外部有手机银行客户端，则直接跳转到工行手机银行进行支付；没有客户端的情况，则在SDK内部进行H5支付。因为需要启动工行客户端，SDK内部调用了 canOpne 方法，请在plist文件中添加工行相应app的白名单。

com.icbc.iphoneclient 融e行 com.icbc.iphoneEChannel 融e联 com.icbc.iphone.emall 融e购 cn.com.icbc.eMallMobileClient 融e购 com.icbc.elife 工银e生活

4.2 本版本SDK支持iOS 7.0以上版本。其他未提及事项，请参考demo工程。

5、特别注意

这部分内容是为工行软件开发团队准备的，提供SDK时需要注意Toast和AFNetWork文件。

左侧是实现Framework用的工程，右侧是模拟商户的工程，此时左右两侧工程的AFnetwork文件夹都引用了15个文件。在编译右侧工程时，会报下面的错误：

错误的意思大致是：重复定义。解决方案：第一种：将右侧商户工程中的AFNET文件夹全部删除，保留左侧的全部15个文件引用，这种方法不太理想，因为商户APP一般会引入AFN文件。因此，如果以这种方式提供SDK，到了商户那里还是会报重复的错误。第二种：本质是.m文件重复，所以，在左侧将所有的.m文件删除，.m文件不引入左侧工程，.h文件保留不变，右侧工程保持不变。

这样就可以了。可以看到，提供出去的framework中第三方组件Toast也是只保留.h文件，这样在商户端可以引用所有的.m.h文件。

2、这里的回调ICBCWebViewJavascriptBridge.js，使用的是商户集成的ICBCPaySDK.Bundle，因此生成framework时不需要将ICBCPaySDK.Bundle关联进去。如下图