测试已测试 | ✓ |
Lang语言 | Obj-CObjective C |
许可 | MIT |
Released最新版本 | 2015年10月 |
由Thomaz Feitoza维护。
依赖于 | |
AFNetworking | = 2.5.4 |
PromiseKit | ~> 1.5 |
RegexKitLite | >= 0 |
这是一个简单的库,用于轻松集成您的移动应用程序与 Gerencianet 提供的支付服务。
该模块处于开发中,基于 Gerencianet 即将发布的新的 API。目前它不能在生产环境中使用。
通过 CocoaPods
pod 'GNApi-Sdk-iOS', '~> 0.2'
直接下载
将 GNApiSdk/
文件夹拖到您的项目中并安装依赖库。
使用 #import "GNApiSdk.h"
或如果使用 CocoaPods,则使用 #import <GNApi-Sdk-iOS/GNApiSdk.h>
导入 SDK 的头文件。
创建一个 GNConfig
对象,定义您的账户代码。如果您处于开发阶段,设置沙盒标志为 YES
GNConfig *gnConfig = [[GNConfig alloc] initWithAccountCode:@"YOUR_ACCOUNT_CODE" sandbox:YES];
通过传递您的 GNConfig
创建一个 GNApiEndpoints
实例
GNApiEndpoints *gnApi = [[GNApiEndpoints alloc] initWithConfig:gnConfig];
要接收支付令牌,您需要一个 GNCreditCard
对象并调用 paymentTokenForCreditCard:
或 paymentTokenForCreditCard:completion:
GNCreditCard *creditCard = [[GNCreditCard alloc] init];
creditCard.number = @"4012001038443335";
creditCard.brand = kGNMethodBrandVisa;
creditCard.expirationMonth = @"05";
creditCard.expirationYear = @"2018";
creditCard.cvv = @"123";
[gnApi paymentTokenForCreditCard:creditCard]
.then(^(GNPaymentToken *paymentToken){
NSLog(@"%@", paymentToken.token);
})
.catch(^(GNError *error){
NSLog(@"An error occurred: %@", error.message);
});
GNApiEndpoints
方法总是返回由 PromiseKit 库提供的承诺对象。
您也可以在获取支付令牌之前获取分期付款信息。您只需要总金额和方法标签。
// The following code will fetch installments for a total of R$10,00 with MasterCard card brand.
GNMethod *method = [[GNMethod alloc] initWithBrand:kGNMethodBrandMasterCard total:@(1000)];
[_gnApi fetchInstallmentsWithMethod:method]
.then(^(GNPaymentData *paymentData){
NSLog(@"%@", paymentData);
})
.catch(^(GNError *error){
NSLog(@"An error occurred: %@", error.message);
});
如果您想获取银行汇票的支付数据而不是信用卡数据,只需使用标签 kGNMethodBrandBankingBillet
初始化 GNMethod
对象。
以下常量定义了可用的方法标签
kGNMethodBrandVisa
kGNMethodBrandMasterCard
kGNMethodBrandAmex
kGNMethodBrandDiners
kGNMethodBrandDiscover
kGNMethodBrandJCB
kGNMethodBrandElo
kGNMethodBrandAura
kGNMethodBrandBankingBillet
此项目已经包括一个示例应用程序。要使用,只需克隆此存储库,使用 pod install
安装依赖库,然后用 XCode 打开。该示例需要您提供账户代码。