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.
- Register with payleven in order to get personal merchant credentials and a card reader.
- In order to receive an API key, please contact us by sending an email to [email protected].
Coming soon...
-
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
-ObjCflag to Other Linker Flags. -
Open the Info.plist and add the following entries:
CFBundleDisplayNamewith the display name for your app.UISupportedExternalAccessoryProtocolswith an array of just one valuecom.adyen.bt1.- For iOS 8:
NSLocationWhenInUseUsageDescriptionorNSLocationAlwaysUsageDescription, for iOS 7:NSLocationUsageDescriptionwith 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.
- Make sure the device is charged and turned on.
- Press '0' key on the card reader for 5 sec and make sure the card reader has entered the pairing mode (there will be a corresponding sign on the screen).
- Go to the bluetooth settings of your iOS device and turn on bluetooth.
- Select the discovered payleven card reader and follow the instructions on both devices to finish the pairing process.
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;
}