iOS integration guide
The Bouncer Insight iOS SDK integration guide.
Please follow the general instructions for installing, setting up permissions, and configuring CardVerify.
Our
VerifyCardAddViewController proactively verifies any cards that users add to your platform. To support this flow, you should use the VerifyCardAddViewController but you don't need to implement the optional fraudModelResultsVerifyCardAdd protocol method in the VerifyCardAddResult protocol:import CardVerify
import UIKit
class VerifyAddFlowViewController: UIViewController, VerifyCardExplanationResult, VerifyCardAddResult {
@IBAction func buttonPressed() {
let vc = VerifyCardAddViewController(userId: self.currentUser.userId)
vc.cardAddDelegate = self
// only use this if you're using a "default to scan" flow
vc.enableManualEntry = true
viewController.present(vc, animated: true, completion: nil)
}
// MARK: -VerifyCardAddResult protocol implementation
func userDidCancelCardAdd(_ viewController: UIViewController) {
dismiss(animated: true)
}
func userDidScanCardAdd(_ viewController: UIViewController, creditCard: CreditCard) {
// Add the card details in `creditCard` to your card entry form
}
func userDidPressManualCardAdd(_ viewController: UIViewController) {
// The user pressed the "enter details manually" button
// navigate to your card entry form without filling in details
}
}
To instrument credit card forms, add the following code to your card entry ViewController:
Stripe Form
Custom Form
import CardVerify
import Stripe
import UIKit
class PaymentFormViewController: UIViewController {
@IBOutlet weak var paymentCardTextField: STPPaymentCardTextField!
@IBOutlet weak var addCardButton: UIButton!
var creditCardFormListener: BouncerFormInstrumentation?
override func viewDidLoad() {
super.viewDidLoad()
guard let viewWithForm = paymentCardTextField.subviews.first else { return }
creditCardFormListener = BouncerFormInstrumentation(userId: self.currentUser.userId, viewWithForm: viewWithForm, fieldOrder: [.cardNumber, .expiry, .cvv, .postalCode], advanceButton: addCardButton)
}
}
import CardVerify
import UIKit
class PaymentFormViewController: UIViewController {
@IBOutlet weak var cardNumberTextField: UITextField!
@IBOutlet weak var expiryTextField: UITextField!
@IBOutlet weak var cvvTextField: UITextField!
@IBOutlet weak var postalCodeTextField: UITextField!
@IBOutlet weak var addCardButton: UIButton!
var creditCardFormListener: BouncerFormInstrumentation?
override func viewDidLoad() {
super.viewDidLoad()
guard let viewWithForm = paymentCardTextField.subviews.first else { return }
creditCardFormListener = BouncerFormInstrumentation(userId: self.currentUser.userId, cardNumberTextField: cardNumberTextField, expiryTextField: expiryTextField, advanceButton: addCardButton, cvvTextField: cvvTextField, postalCodeTextField: postalCodeTextField)
}
}
To provide signals for our risk engine, we also log events around signup and login actions.
In your user signup flow, create an
UserCreateEvent object and invoke the recordSuccess method after creating a user successfully:import CardVerify
class SignupViewController: UIViewController {
private let userCreateEvent = UserCreateEvent()
private func createUser(userName: String, password: String) -> Bool {
// create a user
val user = MyApi.createUser(userName, password)
if (user != null) {
userCreateEvent.recordSuccess(userId: user.id, loginIdentifier: userName)
}
return user != null
}
}
In your login flow, create an
UserLoginEvent object and invoke the recordSuccess method after a successful login attempt, and invoke the recordFailure method after an unsuccessful login attempt:class UserLoginViewController: UIViewController {
private let userLoginEvent = UserLoginEvent()
private func userLogin(userName: String, password: String) {
// log the user in
guard let user = MyApi.getUserFromUserName(userName) else {
showLoginFailed()
return
}
user.login(password) { authToken in
if (authToken != null) {
userLoginEvent.recordSuccess(userId: user.id, loginIdentifier: userName)
} else {
userLoginEvent.recordFailure(loginIdentifier: userName)
showLoginFailed()
}
}
}
}