GNApi-Sdk-iOS 0.3.0

GNApi-Sdk-iOS 0.3.0

测试已测试
Lang语言 Obj-CObjective C
许可 MIT
Released最新版本2015年10月

Thomaz Feitoza维护。



 
依赖于
AFNetworking= 2.5.4
PromiseKit~> 1.5
RegexKitLite>= 0
 

  • thomazfeitoza

gn-api-sdk-ios

这是一个简单的库,用于轻松集成您的移动应用程序与 Gerencianet 提供的支付服务。

:warning: 该模块处于开发中,基于 Gerencianet 即将发布的新的 API。目前它不能在生产环境中使用。

要求

  • iOS 7.0+
  • ARC

依赖关系

安装

通过 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 打开。该示例需要您提供账户代码。

许可证

MIT