Client-Side Implementation

iOS v5SDK

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

Collecting device data

PayPalDataCollector enables you to collect data about a customer's device and correlate it with a session identifier on your server.

Get the SDK

CocoaPods

Include Braintree/PayPalDataCollector in your Podfile:

# Podfile
pod 'Braintree/PayPalDataCollector'

Swift Package Manager

Include the PayPalDataCollector framework.

Carthage

Include the PayPalDataCollector and PPRiskMagnes frameworks.

Implementation

PayPalDataCollector collects data about a customer's device and returns a device_data string that contains one or more identifiers that correlate with the collected data. Collecting and passing this data with transactions helps reduce decline rates.

1. Before making a request to your server, get the device data string by calling collectPayPalDeviceData.

let deviceData = PPDataCollector.collectPayPalDeviceData()
print("Send this device data to your server: (deviceData)")

To collect device data as expected in sandbox you must use iOS v5.9.0+. Call collectDeviceData(isSandbox: Bool) to collect the appropriate device data.

// for production pass 'isSandbox' as 'false'
self.dataCollector.collectDeviceData(isSandbox: true) { deviceData in
    // Send deviceData to your server
}

1. Send the device data string to your server along with transaction or verification data (e.g. Transaction.sale calls). Your server will include this device_data parameter when submitting the request to the Braintree gateway.

note

If you choose to automatically vault a customer's new payment method, verifications for those payment methods will not include device data when they are evaluated by our Premium Fraud Management Tools. Subsequent transactions can still pass device data.

PayPal

If you're accepting PayPal using the Vault flow, collecting device data via PayPalDataCollector is required.