Braintree.h

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>

#import <Braintree/Braintree-API.h>
#import <Braintree/Braintree-PayPal.h>
#import <Braintree/Braintree-Payments-UI.h>
#import "BTDropInViewController.h"

/// The `Braintree` class is the front door to the Braintree SDK for iOS. It contains
/// everything you need to easily start accepting payments in your mobile app.
///
/// You can choose: Drop-In or Custom.
///
/// With Drop-In, you can rely us to provide a fast, easy-to-use UI, which your users will
/// interact with in order to provide payment details. The result, from the programmer's
/// perspective, is a nonce. Send this nonce to your server to perform a variety of payment 
/// operations, such as creating a sale.
///
/// With custom, you have control of your UI, but errors will be handled on the
/// server-side via multiple server-side calls to Braintree. Like Drop-In, the end result is
/// a nonce, which you may transmit to your servers.
///
/// For advanced integrations, you should use BTClient, BTPayPalButton, BTDropInViewController, etc. directly.
@interface Braintree : NSObject

/// Returns an instance of `Braintree`, the public interface of Braintree-iOS.
///
/// @param clientToken value that is generated on your sever using a Braintree server-side
///  client library that contains all necessary configuration to setup the client SDKs. It also
///  authenticates the application to communicate directly to Braintree.
///
/// @see BTClient+Offline.h for offline client tokens that make it easy to test out the SDK without a
///  server-side integration.
///
/// @note You should generate a new client token before each checkout to ensure it has not expired.
///
/// @return An instance of the Braintree Library to perform payment operations.
+ (Braintree *)braintreeWithClientToken:(NSString *)clientToken;


#pragma mark Drop In

/// Creates and returns a payment flow for accepting credit card and PayPal-based payments.
///
/// Present this view controller in your app to prompt your user for payment info, and you will
/// receive a payment method nonce.
///
/// @param delegate Delegate that is notified of success with a payment method containing a payment method nonce or an error.
///
/// @return A Drop-In view controller to be presented in your app's payment flow.
- (BTDropInViewController *)dropInViewControllerWithDelegate:(id<BTDropInViewControllerDelegate>)delegate;


#pragma mark Custom

/// Creates and returns a PayPal button that can be added to the UI. When tapped, this button will initiate the PayPal authorization flow.
///
/// @param delegate Delegate that is notified of completion, receiving either a payment method with a nonce (upon user agreement and success) or an error (upon failure).
///
/// @return A PayPal button to be added as a subview in your UI.
- (BTPayPalButton *)payPalButtonWithDelegate:(id<BTPayPalButtonDelegate>)delegate;


/// Creates and returns a nonce for the given credit card details.
///
/// @note The credit card details provided are not validated until a
///  Braintree operation, such as `Transaction.Create` is performed on
///  your server.
///
/// @param cardNumber      Card number to tokenize
/// @param expirationMonth Card's expiration month
/// @param expirationYear  Card's expiration year
/// @param CVV		       Card's CVV
/// @param postalCode      Postal code of the billing address
/// @param completionBlock Completion block that is called exactly once asynchronously, providing either a nonce upon success or an error upon failure.
- (void)tokenizeCardWithNumber:(NSString *)cardNumber
               expirationMonth:(NSString *)expirationMonth
                expirationYear:(NSString *)expirationYear
                           CVV:(NSString *)CVV
                    postalCode:(NSString *)postalCode
                    completion:(void (^)(NSString *, NSError *))completionBlock;


#pragma mark Advanced Integrations

/// A pre-configured BTClient based on your client token.
///
/// You can use this client when setting BTPayPalButton or BTDropInViewController's client.
@property (nonatomic, readonly) BTClient *client;


#pragma mark - Library Metadata

/// Returns the current library version.
///
/// @return A string representation of this library's current semver.org version (if integrating with CocoaPods).
+ (NSString *)libraryVersion;


@end