AdressCheck

Analytics
Our SDKs by default collect information about the user and running environment to better map fraudsters and understand their behaviors. We recommend keeping this collection active as the sole purpose of this data is for fraud reduction, but if you wish, you can disable it by the parameter .setAnalyticsSettings(boolean useAnalytics).
Required permissions
In the info.plist file, add the permissions below:
Privacy - Location Always and When In Use Usage Description
Privacy - Location Always Usage Description
Privacy - Location Usage Description
Privacy - Location When In Use Usage Description
​
Runtime Permissions
Permission
Reason
Required?
LocationAlwaysAuthorization
To check in the background if the user lives where he/she informed
Yes
​
Starting the SDK
In the application:didFinishLaunchingWithOptions: method of your AppDelegate file, enter:
import AddressCheck
​
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        
        //Inicializa SDK
        AddressCheck.initSDK()
        
        return true
    }
}
​
How to use
First create an object of type AddressCheck. This object is for you to configure all your business rules for the address check:
let AddressCheck = new AddressCheck.Builder(mobileToken: mobileToken, peopleId: peopleId)
    // see a table belowwe
    .build();
​
Parameter
Required?
mobileToken: String
Usage token associated with your CAF account
Yes
peopleId: String
Identifier of the user whose address is being validated
Yes
.setAnalyticsSettings(boolean useAnalytics)
Enables/disables data collection for analytics​
No, the default is true
.setNetworkSettings(int requestTimeout)
Change the default network settings
No. The default is 60 (seconds)
​
With this object created, and after collecting the address entered by your user, implement the delegate, and its mandatory methods, AddressCollectionDelegate to your class, create an object of type AddressCollection, passing the object created earlier, and assign the address, as in the example:
let addressCollection = AddressCollection(addressCheck: addressCheck)
​
addressCollection.delegate = self
​
let address = Address()
// see the table below
​
addressCollection.setAddress(address)
​
Address
For address submission, you must enter the following fields:
Address address = new Address()
address.locale = Locale.init(identifier: "pt-br")
address.countryName = COUNTRY_NAME
address.countryCode = COUNTRY_CODE
address.adminArea = ADMIN_AREA
address.subAdminArea = SUB_ADMIN_AREA
address.locality = LOCALITY
address.subLocality = SUB_LOCALITY
address.thoroughfare = THOROUGHFARE
address.subThoroughfare = SUB_THOROUGHFARE
address.postalCode = POSTAL_CODE
​
Parameter
Example
countryName
Country Name
"Brasil"
countryCode
Código do país
"BR"
adminArea
State
"Rio Grande do Sul"
subAdminArea
State Region
"Porto Alegre"
locality
City
"Porto Alegre"
subLocality
Neighborhood
"Azenha"
thoroughfare
Street/Avenue
"Av. Azenha"
subThoroughfare
Number
"200"
postalCode
ZIP CODE
"51110-100"
​
That's it! After that, our SDK is already evaluating your user's location in the background to verify that he actually lives at the address you entered.
Checking the Address Validation Status
To check the status of the address validation, use the following route:
Resource: https://api.mobile.combateafraude.com/address/{peopleId}?project=ios​
Method: GET
Response
Status: 200 (OK)
Body
Field
Type
Required
Description
last_activity_ts
number
Yes
Timestamp of the last update
installations
object
No
Device(s) where this user ID was used
address_verification
object
No
Verification of address(es)

FaceAuthenticator

DeviceAnalyser

Last modified 4mo ago

Permission	Reason	Required?
`LocationAlwaysAuthorization`	To check in the background if the user lives where he/she informed	Yes

Parameter	Required?
`mobileToken: String` Usage token associated with your CAF account	Yes
`peopleId: String` Identifier of the user whose address is being validated	Yes
`.setAnalyticsSettings(boolean useAnalytics)` Enables/disables data collection for analytics	No, the default is `true`
`.setNetworkSettings(int requestTimeout)` Change the default network settings	No. The default is 60 (seconds)

Parameter	Example
`countryName` Country Name	"Brasil"
`countryCode` Código do país	"BR"
`adminArea` State	"Rio Grande do Sul"
`subAdminArea` State Region	"Porto Alegre"
`locality` City	"Porto Alegre"
`subLocality` Neighborhood	"Azenha"
`thoroughfare` Street/Avenue	"Av. Azenha"
`subThoroughfare` Number	"200"
`postalCode` ZIP CODE	"51110-100"

Field	Type	Required	Description
`last_activity_ts`	`number`	Yes	Timestamp of the last update
`installations`	`object`	No	Device(s) where this user ID was used
`address_verification`	`object`	No	Verification of address(es)