| TestsTested | ✗ |
| LangLanguage | Obj-CObjective C |
| License | MIT |
| ReleasedLast Release | May 2015 |
Maintained by Johannes Rupieper.
This project provides an iOS API to communicate with the payleven Chip & PIN card reader in order to accept debit and credit card payments. Learn more about the Chip & PIN card reader and payment options on one of payleven's regional websites.
Drag PaylevenSDK.framework, AdyenToolkit.framework, and AdyenToolkit.bundle into your Xcode project.
Open the Build Phases of your target and add the following frameworks to the Link Binary With Libraries section:
CoreData.framework
CoreLocation.framework
ExternalAccessory.framework
SystemConfiguration.framework
libsqlite3.0.dylib
Open the Build Settings of your target and add -ObjC flag to Other Linker Flags.
Open the Info.plist and add the following entries:
CFBundleDisplayName with the display name for your app.UISupportedExternalAccessoryProtocols with an array of just one value com.adyen.bt1.NSLocationWhenInUseUsageDescription or NSLocationAlwaysUsageDescription,\n for iOS 7: NSLocationUsageDescription with the location usage description message for the users.Import PaylevenSDK into your files:
#import <PaylevenSDK/PaylevenSDK.h>
Before proceeding with the integration and testing make sure you have paired the card reader in the bluetooth settings on your iOS device.
Use API key received from payleven together with your payleven merchant account to authenticate your app. Hint: Check out our Sample Demo to see how you can easily observe the Login State using KVO.
PLVPayleven * payleven = [[PLVPayleven alloc] init];
[payleven loginWithUsername:@"aUsernameString"
password:@"aPasswordString"
APIKey:@"anApiKey"
completionHandler:^(NSError *error) {
if (error == nil) {
// Congrats, you're Logged In
} else {
// Error Handling
}
}];Once a PLVPayleven instance is created you need to select the card reader for your future payments.
//You probably want to visualize the devices in a UITableView
NSArray * pairedDevices = self.payleven.devices;
//Get the selected device from the list
PLVDevice *device = self.sortedDevices[indexPath.row];
NSString * deviceName = device.name;
Prepare selected device for upcoming payment.
[device prepareWithCompletionHandler:^(NSError *error) {
if (device.isReady) {
//Device is Ready, now let's do some Payment
} else {
// Error Handling
}
}];Initialize the actual payment request. For security purposes you must provide the user's current location in the PaymentReuest.
//Here we are using an arbitrary location. In your app you must provide the user's current location
CLLocationCoordinate2D coordinate = CLLocationCoordinate2DMake(52.5243700, 13.4105300);
NSLocale* locale = [NSLocale currentLocale];
NSDecimalNumber* amount = [NSDecimalNumber decimalNumberWithString:@"1.00" locale:locale];
PLVPaymentRequest* request = [[PLVPaymentRequest alloc] initWithIdentifier:@"anArbitraryUniqueIdentifier"
amount:amount
currency:@"EUR"
coordinate:coordinate];
//Hint: the corresponding delegate is PLVPaymentTaskDelegate
self.paymentTask = [self.payleven paymentTaskWithRequest:request device:self.device delegate:self]
if (self.paymentTask == nil) {
//Could not create Payment
} else {
[self.paymentTask start];
}
Implement PLVPaymentTaskDelegate's methods to respond to payment events such as the request of a payer's signature, its final approval or any errors.
- (void)paymentTask:(PLVPaymentTask *)paymentTask
needsSignatureWithCompletionHandler:(void (^)(BOOL, CGImageRef))completionHandler {
UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
UINavigationController *navigationController
= [storyboard instantiateViewControllerWithIdentifier:@"SignatureConfirmationNavigationController"];
SignatureConfirmationViewController *signatureConfirmationViewController
= (SignatureConfirmationViewController *)navigationController.topViewController;
//Get Payer's signature and return using completionBlock (See our Sample App for full implementation)
UIImage * signature = ...
completionHandler(true, signature.CGImage);
}
- (void)paymentTaskDidFinish:(PLVPaymentTask *)paymentTask {
self.receiptGenerator = paymentTask.result.receiptGenerator;
CGFloat scale = [UIScreen mainScreen].scale;
[self.receiptGenerator generateReceiptWithWidth:(384.0 * scale)
fontSize:(16.0 * scale)
lineSpacing:(8.0 * scale)
padding:(20.0 * scale)
completionHandler:
^(CGImageRef receipt) {
CGFloat scale = [UIScreen mainScreen].scale;
UIImage *image = [UIImage imageWithCGImage:receipt scale:scale orientation:UIImageOrientationUp];
self.receiptGenerator = nil;
}];
self.paymentTask = nil;
}
- (void)paymentTask:(PLVPaymentTask *)paymentTask didFailWithError:(NSError *)error {
//Error handling
self.paymentTask = nil;
}