XHPKit 1.0.3

XHPKit 1.0.3

CoderZhuXH维护。



XHPKit 1.0.3

  • 作者
  • 朱晓辉

XHPayKit

不使用官方SDK实现微信支付、支付宝支付

AppVeyor Version Status Support Pod Platform Pod License

技术交流群(群号:537476189)

写在最前

1.此库拥有和官方SDK相似的接口,可以直接替换官方SDK支付接口,如果您使用过官方SDK,那么转换为本库您只需花费极短时间。
2.此库只有10kb大小,不用导入任何依赖库,便可实现微信支付、支付宝支付。如果您想为项目瘦身或由于某种原因,不想使用官方SDK实现支付功能,此库将是一个不错的选择。
3.使用此库时,不需要配置微信等平台appid等信息,服务端配置就可以了,支付不同于登录分享,参数均由后台生成,后台签名订单时会返回appid等信息给客户端。

如果您不想让审核人员扫描到APP里面的支付功能,请看这里>>>[点击链接查看](https://github.com/CoderZhuXH/XHPayKit/blob/master/%E5%AE%A1%E6%A0%B8%E9%98%B2%E6%A3%80%E6%B5%8B%E5%88%B0%E6%94%AF%E4%BB%98%E5%8A%9F%E8%83%BD%E7%89%88%E6%9C%AC/README.md)

注意

1.首先在微信、支付宝开放平台注册您的应用,并获得支付权限
2.导入此库,并将 weixin、alipay 字段添加到 info.plist 的白名单中
3.添加两个 URL Schemes,如图所示

运行 Demo 注意事项

由于 demo 在唤起支付时未传递真实支付参数,因此无法真正进行支付。请替换为真实订单参数即可(这些参数由后台订单签名时生成并返回客户端)。

代码示例

1.微信支付

//以下参数详细介绍见微信官方文档:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12&index=2

//微信支付参数,下面7个参数,由后台签名订单后生成,并返回给客服端(与官方SDK一致)
//注意:请将下面参数设置为你自己真实订单签名后服务器返回参数,便可进行实际支付

XHPayWxReq *req = [[XHPayWxReq alloc] init];
req.openID = @"";//微信开放平台审核通过的应用APPID
req.partnerId = @"";//商户号
req.prepayId = @"";//交易会话ID
req.nonceStr = @"";//随机串,防重发
req.timeStamp = 1518156229;//时间戳,防重发
req.package = @"";// 扩展字段,暂填写固定值Sign=WXPay
req.sign = @"";//签名
        
//传入订单模型,拉起微信支付
[[XHPayKit defaultManager] wxpayOrder:req completed:^(NSDictionary *resultDict) {
      NSLog(@"支付结果:\n%@",resultDict);
      NSInteger code = [resultDict[@"errCode"] integerValue];
      if(code == 0){//支付成功
                
      }
}];

        

2.支付宝支付

//支付宝订单签名,此签名由后台签名订单后生成,并返回给客户端(与官方SDK一致)
//注意:请将下面值设置为你自己真实订单签名,便可进行实际支付
NSString *orderSign = @"很长的一串支付宝订单签名";
        
//传入支付宝订单签名 和 自己App URL Scheme,拉起支付宝支付
[[XHPayKit defaultManager] alipayOrder:orderSign fromScheme:@"XHPayKitExample" completed:^(NSDictionary *resultDict) {
    NSLog(@"支付结果:\n%@",resultDict);
    NSInteger status = [resultDict[@"resultStatus"] integerValue];
    if(status == 9000){//支付成功
                
    }
}];

3.在 Appdelegate 中添加以下代码 - 处理第三方支付跳回商户 app 携带的支付结果 URL

#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_9_0
/** iOS9及以后 */
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
    BOOL result = [[XHPayKit defaultManager] handleOpenURL:url];
    if (!result) {//这里处理其他SDK(例如QQ登录,微博登录等)
        
    }
    return result;
}
#endif
/** iOS9以下 */
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
    BOOL result = [[XHPayKit defaultManager] handleOpenURL:url];
    if (!result) {//这里处理其他SDK(例如QQ登录,微博登录等)
        
    }
    return result;
}

其它接口

/**
 是否安装微信

 @return 已安装YES,未安装NO
 */
+(BOOL)isWxAppInstalled;

/**
 是否安装支付宝

 @return 已安装YES,未安装NO
 */
+(BOOL)isAliAppInstalled;

支付结果resultDict解释

微信

{
    "errCode":0,
    "errStr":"成功"
}

//以下状态码含义与官方SDK一致
errCode = 0,成功<br>
errCode = -1,普通错误类型<br>
errCode = -2,用户点击取消并返回<br>
errCode = -3,发送失败<br>
errCode = -4,授权失败 <br>
errCode = -5,微信不支持<br>

支付宝

{
    "result":"",
    "resultStatus":"9000",
    "memo":"支付成功"
}

//以下状态码含义与官方SDK一致
resultStatus = 9000,支付成功<br>
resultStatus = 8000,正在处理中,支付结果未知(有可能已经支付成功),请查询商户订单列表中订单的支付状态<br>
resultStatus = 4000,支付失败<br>
resultStatus = 5000,重复请求<br>
resultStatus = 6001,用户中途取消<br>
resultStatus = 6002,网络连接出错<br>
resultStatus = 6004,支付结果未知(有可能已经支付成功),请查询商户订单列表中订单的支付状态<br>

安装

1.手动添加

  • 1.将 XHPayKit 文件夹添加到项目目录中
  • 2.导入 XHPayKit.h

2.CocoaPods

  • 1.在 Podfile 中添加 pod 'XHPayKit'
  • 2.执行 pod install 或 pod update
  • 3.导入 XHPayKit.h

3.小贴士

  • 1.如果在终端执行 pod search XHPayKit 后提示:[!] Unable to find a pod with name, author, summary, or description matching XHPayKit,请在终端上执行 rm ~/Library/Caches/CocoaPods/search_index.json,然后重新执行 pod search XHPayKit
  • 2.如果发现 pod search XHPayKit 搜索的不是最新版本,需要在终端执行 cd ~/desktop 退回到 desktop,然后执行 pod setup 命令更新本地spec缓存(需要几分钟),然后再进行搜索
  • 3.如果发现执行 pod install 后导入的不是最新版本,请删除 Podfile.lock 文件,然后再次执行 pod install
  • 4.如果在使用过程中遇到BUG,希望您能提交Issues给我,谢谢(或者尝试下载最新的代码看看BUG是否已修复)

系统要求

  • 该项目最低支持 iOS 7.0 和 Xcode 8.0

许可证

XHPayKit 使用 MIT 许可证,详情见 LICENSE 文件