https://github.com/jflinter/applepaystubs

https://github.com/jflinter/applepaystubs

Last synced: 21 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/jflinter/applepaystubs
• Owner: jflinter
• Created: 2014-10-08T00:36:47.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2014-10-08T00:37:10.000Z (about 10 years ago)
• Last Synced: 2024-10-16T08:55:55.305Z (2 months ago)
• Language: Objective-C
• Size: 105 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        
ApplePayStubs

===

What is this?

---

ApplePay is awesome, and like many developers we're excited to work with it. However, testing and developing for it is currently difficult as Apple hasn't released any public versions of the iOS SDK with it enabled. Furthermore, even when it is released, it will require a new iPhone to actually see and test the UI.

We've created a replacement component for `PKPaymentAuthorizationViewController` (the primary class involved in ApplePay transactions) for businesses interested in working with ApplePay called `STPTestPaymentAuthorizationViewController`. These classes appear visually similar and behave almost identically. The primary difference is that `STPTestPaymentAuthorizationViewController` yields test credit cards and addresses instead of accessing actual information stored on a user's iPhone. You can use it to build and test all of your UI and application logic around ApplePay, and switch it out for the real thing once ApplePay is publicly released.

Please note that this is for *testing purposes only*.

Dependencies

---

- Xcode 6+

- iOS 8+

ApplePayStubs also depends on the `PassKit` framework.

Installation

---

Use Cocoapods or manually add the files to your repository.

Usage

---

You create and use instances of `STPTestPaymentAuthorizationViewController` exactly the same way as with 

`PKPaymentAuthorizationViewController`.

//ViewController.m

PKPaymentRequest *request = ...;

UIViewController *controller;

#if DEBUG

  controller = [[STPPaymentAuthorizationViewController alloc] initWithPaymentRequest:request];

  controller.delegate = self;

#else

  controller = [[PKPaymentAuthorizationViewController alloc] initWithPaymentRequest:request];

  controller.delegate = self;

#endif

[self presentViewController:controller];

`STPTestPaymentAuthorizationViewController` will trigger the same `PKPaymentAuthorizationViewControllerDelegate` callbacks at the appropriate time on its delegate.

- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller didSelectShippingAddress:(ABRecordRef)address

                                completion:(void (^)(PKPaymentAuthorizationStatus status, NSArray *shippingMethods, NSArray *summaryItems))completion {

    [self fetchShippingCostsForAddress:address completion:^(NSArray *shippingMethods, NSError *error) {

        if (error) {

            completion(PKPaymentAuthorizationStatusFailure, nil, nil);

            return;

        }

        completion(PKPaymentAuthorizationStatusSuccess, shippingMethods, [self summaryItemsForShippingMethod:shippingMethods.firstObject]);

    }];

}

- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller

                   didSelectShippingMethod:(PKShippingMethod *)shippingMethod completion:(void (^)(PKPaymentAuthorizationStatus, NSArray *summaryItems))completion {

    completion(PKPaymentAuthorizationStatusSuccess, [self summaryItemsForShippingMethod:shippingMethod]);

}

- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller {

    [self dismissViewControllerAnimated:YES completion:nil];

}

When the user finishes selecting a card, as usual `STPTestPaymentAuthorizationViewController` will call `paymentAuthorizationViewController:didAuthorizePayment:completion` on its delegate.

 This usually includes a `PKPayment` that contains encrypted credit card data that you'd pass off to your payment processor (such as Stripe). To approximate this functionality, we attach a credit card number to the `PKPayment` under the `stp_testCardNumber` property. If you're using Stripe to handle this token, you can use our existing card APIs to turn this into a token:

 - (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller

                        didAuthorizePayment:(PKPayment *)payment

                                 completion:(void (^)(PKPaymentAuthorizationStatus))completion {

     void(^tokenBlock)(STPToken *token, NSError *error) = ^void(STPToken *token, NSError *error) {

         if (error) {

             completion(PKPaymentAuthorizationStatusFailure);

         }

         else {

             [self createBackendChargeWithToken:token completion:completion];

         }

     };

 #if DEBUG

     STPCard *card = [STPCard new];

     card.number = payment.stp_testCardNumber;

     card.expMonth = 12;

     card.expYear = 2020;

     card.cvc = @"123";

     [Stripe createTokenWithCard:card completion:tokenBlock];

 #else

     [Stripe createTokenWithPayment:payment

                     operationQueue:[NSOperationQueue mainQueue]

                         completion:tokenBlock];

 #endif

 }

(Note: Stripe tokens created from Apple Pay work interchangably with those created using manually-collected credit card details).