BGPay
示例
要运行示例项目，请先克隆仓库，然后从示例目录中运行 pod install。
使用方法
最低支持版本
- iOS >= 8.0
使用 CocoaPods 安装
BGPaySDK 可通过 CocoaPods 获取。要安装它，只需将以下行添加到您的 Podfile 中：
pod 'BGPay'手动安装
下载依赖库地址.
依赖框架：
- AFNetworking.framework(.a)
- BGPay.framework
BGPay.framework AFNetworking.a 依赖到 Linked Framework And Librarise
注意:如果使用了AFNetworking.framework(动态库),需要将AFNetworking.framework 依赖到 Embedded Binaries.配置
生命周期
-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
if ([url.host isEqualToString:@"BigoClient"]) {
//TODO:此处处理回调结果
NSString *appId = @"1084695898372562946";
NSString *mchId = @"980822476815695873";
NSString *outTradeNo = @"bg201812031530292177781207016";
[BGPay getPayOrderWithAppId:appId andMchId:mchId andOutTradeNo:outTradeNo success:^(NSString *result) {
NSLog(@"%@",result);
} failed:^(NSString *result, BGPayError *error) {
NSLog(@"%ld", (long)error.errorCode);
NSLog(@"%@",error.errorMessage);
}];
}
return YES;
}URL Schemes
URL Schemes "创建APP Scheme"
LSApplicationQueriesSchemes 白名单 添加 "BigoClient"统一下单
应用场景：
- 商户系统首先调用该接口在BGSDK生成预支付交易单，成功后调用BG客户端，并可以在线支付，失败后返回对应错误信息。
方法：
- (void)payOrder:(BGOrder *)order scheme: (NSString *)formsScheme success: (successBlock)successBlock failed: (failBlock)failBlock;
参数：
order
V2.0版本之前
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用ID |
| mchId | 是 | string | 商户号 |
| nonceStr | 是 | string | 随机字符串 |
| outTradeNo | 是 | string | 商户订单号 |
| totalFee | 是 | string | 总金额 |
| notifyUrl | 否 | string | 通知地址 |
| sign | 是 | string | 签名算法 |
V2.0版本之后
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用ID |
| mchId | 是 | string | 商户号 |
| 密文 | 是 | string | 签名算法 |
方案
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| 表单方案 | 是 | string | 应用方案 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| 结果 | 字符串 | 参数格式验证错误 |
| 错误 | BG支付错误 | 错误信息 |
V2.0版本之前
NSString *appId = @"1084695898372562946";
NSString *mchId = @"980822476815695873";
NSString *nonceStr = @"123456789";
NSString *outTradeNo = @"bgTest123456789";
NSString *totalFee = @"10";
NSString *notifyUrl = @"http://192.168.1.108:7076/pay/getOrder";
/// 签名信息
NSString *sign = @"XXXX";
BGOrder *order = [BGOrder orderWithAppId:appId andMchId:mchId andNonceStr:nonceStr andOutTradeNo:outTradeNo andTotalFee:totalFee andSign:sign andNotifyUrl:notifyUrl];
[BGPay payOrder:order scheme:@"OtherApp" success:^(NSString *result) {
NSLog(@"%@",result);
} failed:^(NSString *result, BGPayError *error) {
NSLog(@"%ld", (long)error.errorCode);
NSLog(@"%@",error.errorMessage);
}];V2.0版本之后
NSString *appId = @"1084695898372562946";
NSString *mchId = @"980822476815695873";
/// 签名信息
NSString *cipherText = @"XXXX";
BGOrder *order = [BGOrder orderWithAppId:appId andMchId:mchId andCipherText:cipherText];
[BGPay payOrder:order scheme:@"OtherApp" success:^(NSString *result) {
NSLog(@"%@",result);
} failed:^(NSString *result, BGPayError *error) {
NSLog(@"%ld", (long)error.errorCode);
NSLog(@"%@",error.errorMessage);
}];支付结果查询
应用场景：
- 该接口提供所有BG支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。
方法：
- (void)获取支付订单：(NSString *)appId，（NSString *）mchId，（NSString *）outTradeNo；
参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用ID |
| mchId | 是 | string | 商户号 |
| outTradeNo | 是 | string | 商户订单号 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| return_code | 字符串 | 此字段是通信标识，非交易标识，交易是否成功需要查看result_code（为0则是正确）来判断 |
| return_msg | 字符串 | 参数格式验证错误 |
NSString *appId = @"1084695898372562946";
NSString *mchId = @"980822476815695873";
NSString *outTradeNo = @"bg201812031530292177781207016";
[BGPay getPayOrderWithAppId:appId andMchId:mchId andOutTradeNo:outTradeNo success:^(NSString *result) {
NSLog(@"%@",result);
} failed:^(NSString *result, BGPayError *error) {
NSLog(@"%ld", (long)error.errorCode);
NSLog(@"%@",error.errorMessage);
}];作者
LiXinLi, [email protected]
许可协议
BGPaySDK在MIT许可协议下可用。更多信息请参阅LICENSE文件。
错误码
| 错误码 | 枚举 | 错误信息 | 解决方案 |
|---|---|---|---|
| 1000 | BGErrUnknownError | 未知错误 | 未知错误 |
| 1001 | BGErrBgNotInstalled | 未安装BG客户端 | 未安装BG客户端 |
| 2011 | BGErrDisableAccount | 用户账号被禁用 | 请联系客服 |
| 2012 | BGErrPasswordError | 资金密码错误 | 请输入正确的支付密码 |
| 2018 | BGErrNonExistUser | 用户不存在 | 用户未注册 |
| 2065 | BGErrInvalidAppId | 应用ID不能为空 | 请输入正确的appId |
| 2066 | BGErrInvalidMchId | 商户号不能为空 | 请输入正确的商户号 |
| 2067 | BGErrInvalidOutTradeNo | 商户订单号不能为空 | 请输入正确的商户订单号 |
| 2068 | BGErrInvalidAccount | 平台未注册 | 请商户前往申请此接口权限 |
| 2069 | BGErrUnknownMchId | 商户号不匹配 | 请商户查看商户号是否正确 |
| 2070 | BGErrDisableMch | 平台已禁用 | 请商户前往申请接触禁用 |
| 2073 | BGErrUnknownPrepayId | 预支付订单号不存在 | 请检查预支付订单号 |
| 2077 | BGErrUnPay | 待支付 | 待支付 |
| 2078 | BGErrPayTimeOut | 支付超时 | 订单支付超时 |
| 2079 | BGErrPaid | 已支付完成 | 订单支付已完成 |
| 2080 | BGErrUnknownSign | 签名错误 | 请检查生成的签名 |
| 3001 | BGErrWithdrawRecord | 提现记录审核存在 | 提现记录已存在，请联系客服审核 |
| 3002 | BGErrUnknownFee | 提现金额需要大于0 | 提现金额需要大于0 |
| 3003 | BGErrUnknownAppId | appId匹配错误 | 请检查appId |
| 3004 | BGErrUnknownMchId2 | 商户号匹配错误 | 请检查商户号 |
| 3005 | BGErrDisableWithdraw | 商户已经禁用提现 | 商户已经禁用提现 |
| 3006 | BGErrNoWithdrawRecord | 提现记录不存在 | 请查看生成提现记录接口 |
| 3007 | BGErrWithdrawRecordFailed | 提现记录审核失败 | 等待平台审核提现记录 |
| 3008 | BGErrWithdrawFailed | 提现记录审核失败 | 提现记录审核失败 |
| 50027 | BGErrNoMoney | 资金不足 | 请充值 |
| 2000000 | BGErrNotAuthUser | 用户尚未完成高级实名认证 | 请用户完成实名认证 |