Client-Side Implementation

iOS v6

• Current Braintree SDKs
• Android v5
• iOS v6
• JavaScript v3
• Previous Versions
• Android v4
• JavaScript v2

Installation

Braintree

pod 'BraintreeVisaCheckout'

SRC

Initialization

1. Configure the VisaCheckoutSDK when your app launches:.
   Swift

   Copy

   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
       VisaCheckoutSDK.configure()
       return true
   }

2. Instantiate a BTAPIClient using the appropriate authorization
   • If using 3D Secure with Visa Checkout, you must use a client token from your server
   • Otherwise, you can choose between a tokenization key or a client token
3. Instantiate a BTVisaCheckoutClient:.
   Swift

   Copy

   let client = BTAPIClient(authorization: "<#CLIENT_AUTHORIZATION#>")!
   self.visaCheckoutClient = BTVisaCheckoutClient(apiClient: client)

4. Create a Profile using the BTVisaCheckoutClient:.
   Swift

   Copy

   self.visaCheckoutClient.createProfile() { (profile, error) in
       guard let profile = profile as? Profile else {
           print("Failed to create Visa profile: (error!)")
           return;
       }
   
       // Customize the Visa Checkout experience
       profile.displayName = "My Merchant Name"
   }

Generating a client token

Specifying payment details

1. Create a PurchaseInfo object, passing in an amount and currency
2. Specify additional payment details on this object, e.g. description, subtotal, shipping

let total = CurrencyAmount(string: "1.00")
let purchaseInfo = PurchaseInfo(total: total, currency: .usd)

// Customize the purchase info
purchaseInfo.customDescription = "My Description"

Tokenizing

1. Create a VisaCheckoutButton and set it up
2. Call visaCheckoutClient.tokenize(CheckoutResult) with a CheckoutResult
3. We tokenize the result and return a VisaCheckoutNonce in the completion block

let checkoutButton = VisaCheckoutButton.init(frame: CGRect.init(x: 0, y: 0, width: 213, height: 47))
self.view.addSubview(checkoutButton)

checkoutButton.onCheckout(profile: profile, purchaseInfo: purchaseInfo, presenting: self, onReady: { (launchHandler) in
    self.launchHandler = launchHandler
}, onButtonTapped: {
    self.launchHandler()
}, completion: { (result) in
    self.client.tokenize(result, completion: { (tokenizedVisaCheckoutCard, error) in
      if error != nil {
          print("Error tokenizing Visa Checkout card: %@", error.localizedDescription)
      } else if tokenizedVisaCheckoutCard != nil {
          // Send this nonce to your server, and create a transaction there.
          let nonce = tokenizedVisaCheckoutCard.nonce

          // Access Visa Checkout properties from this `VisaCheckoutCardNonce`, e.g.
          let shippingAddress = tokenizedVisaCheckoutCard.shippingAddress
      } else {
          // User canceled.
      }
    })
})