Skip to content

Card Vaulting

SDK version 2.7.0 and later supports an optional Card Vaulting module which enables users to link additional credit and debit cards with Cardlytics.

Info

Card vaulting does not apply to marketplaces who send transactions to Cardlytics directly.

To utilize the Card Vaulting module:

  1. Please make sure you have already integrated the Powered By Mobile SDK into your existing application.
  2. Include the DoshCardVaulting module through your client codebase's dependency manager. Please see below for each platform's reference code for including the DoshCardVaulting module.
  3. If your marketplace supports card vaulting, it will be enabled server side by default. If you would like to add card vaulting, please reach out to our publisher team.
1. Direct Download

Direct download is available from the following URLs. Replace <major.minor.patch> in the URL with the SDK version you would like to download. GitHub tag (latest SemVer)

1
2
https://poweredby-sdk-release.dosh.com/ios/<major.minor.patch>/PoweredByDosh.zip
https://poweredby-sdk-release.dosh.com/ios/<major.minor.patch>/DoshCardVaulting.zip

When supporting Card Vaulting, both the PoweredByDosh and DoshCardVaulting frameworks must be included in your target.

2. CocoaPods

Include the following declaration in your Podfile:

1
2
# Podfile
pod 'PoweredByDosh/DoshCardVaulting'

This declaration will install both the base PoweredByDosh framework as well as the DoshCardVaulting module.

3. Carthage

Include the following declaration in your Cartfile:

1
2
# Cartfile
binary "https://poweredby-sdk-release.dosh.com/ios/PoweredByDosh-Carthage.json"

When supporting Card Vaulting, both the PoweredByDosh and DoshCardVaulting frameworks must be included in your target.

4. Swift Package Manager

Swift Package Manager is available for SDK versions 2.3.0 and later when building with Xcode 12 by using the following URL as the package source:

1
https://github.com/dosh-com/powered-by-dosh-ios-releases.git

When integrating the package, you will have the option to choose which framework targets to include. You should include both PoweredByDosh and DoshCardVaulting.

GitHub tag (latest SemVer)

Card vaulting support is provided through our maven repository. Please add the following to the buildscript block in your root build.gradle script:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
allprojects {
    ...
    repositories {
        ...
        //The maven repository for Cardlytics.
        maven {
            url = "https://dosh.jfrog.io/dosh/libs"
            //Note: There is a bug with Artifactory and though this is a public repository
            //      you will need to submit blank credentials in order for access to the repository.
            credentials {
                username = ""
                password = ""

            }
        }
    }
}

Then in your dependency block in your app build.gradle add the following:

1
2
implementation('com.dosh:poweredby:{latest_version}')
implementation('com.dosh:dosh-card-vaulting:{latest_version}')

Card Enrollment Callback

You can be notified through the SDK of card link events by opting in to our Custom Callback Support using the SDK constant DoshCallback.CardLinkSuccess.

A server-to-server notification is available as well. Please see the related features below.

Once a card has been linked with Cardlytics, it will be visible to the user in the Card Management module.