card.io SDK for Android
card.io provides fast, easy credit card scanning in mobile apps.
Stay up to date
Please be sure to keep your app up to date with the latest version of the SDK. All releases follow semantic versioning.
The latest version is available via mavenCentral(). Just add the following dependency:
compile 'io.card:android-sdk:5.5.1'
You can receive updates about new versions via a few different channels:
- Follow @cardio (also great to send us feedback)
- Subscribe to our card-io-sdk-announce list.
- "Watch" this GitHub repository
Also be sure to check and post to the Stack Overflow card.io tag.
Integration instructions
The information in this guide is enough to get started. For additional details, see our javadoc.
(Note: in the past, developers needed to sign up at the card.io site and obtain an app token. This is no longer required.)
Requirements for card scanning
- Rear-facing camera.
- Android SDK version 16 (Android 4.1) or later.
- armeabi-v7a, arm64-v8, x86, or x86_64 processor.
A manual entry fallback mode is provided for devices that do not meet these requirements.
Setup
Add the dependency in your build.gradle:
compile 'io.card:android-sdk:5.5.0'
Sample code (See the SampleApp for an example)
First, we'll assume that you're going to launch the scanner from a button, and that you've set the button's onClick handler in the layout XML via android:onClick="onScanPress". Then, add the method as:
public void onScanPress(View v) {
Intent scanIntent = new Intent(this, CardIOActivity.class);
// customize these values to suit your needs.
scanIntent.putExtra(CardIOActivity.EXTRA_REQUIRE_EXPIRY, true); // default: false
scanIntent.putExtra(CardIOActivity.EXTRA_REQUIRE_CVV, false); // default: false
scanIntent.putExtra(CardIOActivity.EXTRA_REQUIRE_POSTAL_CODE, false); // default: false
// MY_SCAN_REQUEST_CODE is arbitrary and is only used within this activity.
startActivityForResult(scanIntent, MY_SCAN_REQUEST_CODE);
}
Next, we'll override onActivityResult() to get the scan result.
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == MY_SCAN_REQUEST_CODE) {
String resultDisplayStr;
if (data != null && data.hasExtra(CardIOActivity.EXTRA_SCAN_RESULT)) {
CreditCard scanResult = data.getParcelableExtra(CardIOActivity.EXTRA_SCAN_RESULT);
// Never log a raw card number. Avoid displaying it, but if necessary use getFormattedCardNumber()
resultDisplayStr = "Card Number: " + scanResult.getRedactedCardNumber() + "\n";
// Do something with the raw number, e.g.:
// myService.setCardNumber( scanResult.cardNumber );
if (scanResult.isExpiryValid()) {
resultDisplayStr += "Expiration Date: " + scanResult.expiryMonth + "/" + scanResult.expiryYear + "\n";
}
if (scanResult.cvv != null) {
// Never log or display a CVV
resultDisplayStr += "CVV has " + scanResult.cvv.length() + " digits.\n";
}
if (scanResult.postalCode != null) {
resultDisplayStr += "Postal Code: " + scanResult.postalCode + "\n";
}
}
else {
resultDisplayStr = "Scan was canceled.";
}
// do something with resultDisplayStr, maybe display it in a textView
// resultTextView.setText(resultDisplayStr);
}
// else handle other activity results
}
Hints & Tips
- Javadocs are provided in this repo for a complete reference.
- Note: the correct proguard file is automatically imported into your gradle project from the
aarpackage. Anyone not using gradle will need to extract the proguard file and add it to their proguard config. - card.io errors and warnings will be logged to the "card.io" tag.
- If upgrading the card.io SDK, first remove all card.io libraries so that you don't accidentally ship obsolete or unnecessary libraries. The bundled libraries may change.
- Processing images can be memory intensive.
- Memory Analysis for Android Applications provides some useful information about how to track and reduce your app's memory useage.
- card.io recommends the use of SSL pinning when transmitting sensitive information to protect against man-in-the-middle attacks.
Contributing
Please read our contributing guidelines prior to submitting a Pull Request.
License
Please refer to this repo's license file.
641 Dec 23, 2022
5 Jan 3, 2022
299 Nov 14, 2022
2 Jun 11, 2022
9 Oct 16, 2022
219 Nov 25, 2022
31 Dec 13, 2022
10 Dec 15, 2022
18 Dec 19, 2022
769 Dec 14, 2022
5 Sep 19, 2022
1.3k Dec 14, 2022
12 Oct 8, 2022
270 Nov 25, 2022
147 Nov 20, 2022
30.5k Dec 27, 2022
802 Dec 22, 2022
615 Dec 1, 2022