README.md

CreditCardEntry

Introduction

This library provides an elegant form for credit card entry that can be easily added to a activity or fragment. Regex is used to validate credit card types and a Luhn check is performed on the card numbers. This form was inspired by the credit entry UI on Square.

• Smooth interface
• Identifies credit card type
• Hides number for privacy
• Supports VISA, MasterCard, Discover and AMEX

Including in your project

This project uses JitPack to build and release.

Add JitPack to the end of your repositories

    repositories {

        ...

        maven { url "https://jitpack.io" }
    }

Add the project to your dependencies

    dependencies {

        ...

        compile 'com.github.dbachelder:CreditCardEntry:1.5.0'
    }

Using the library

Please see below for an example.

XML

        <com.devmarvel.creditcardentry.library.CreditCardForm
            android:id="@+id/credit_card_form"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            app:helper_text_color="@color/yellow_500"
            app:include_helper="false"
            app:include_zip="false"/>

• app:text_color - change the input field's text color (Color.BLACK by default).
• app:hint_text_color - change the input field's hint text color (Color.LTGRAY by default).
• app:cursor_color - change the input field's cursor color (Color.BLACK by default).
• app:default_text_colors - If true, use text colors provided by the app's theme instead of the values provided by app:text_color,app:hint_text_color, and app:cursor_color. This overrides the values for those three text colors and causes the text inputs to use the colors provided by the application's theme.
• app:include_helper - boolean to show/hide the helper text under the widget (true by default (i.e. helper is shown))
• app:helper_text_color - change the text color of the hints that appear below the widget by default.
• app:include_zip - boolean to show/hide the zip code in the form (true by default (i.e. zip is shown))
• app:include_exp - boolean to show/hide the exp in the form (true by default (i.e. exp is shown))
• app:include_security - boolean to show/hide the security code in the form (true by default (i.e. security is shown))
• app:card_number_hint - string to put in as a placeholder (hint) in the credit card number field
• app:input_background - the drawable to use as a background (defaults to white square with black 1px border)

In code:

    public class MainActivity extends Activity {
  
      private LinearLayout linearLayout;
      private CreditCardForm form;
  
      protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
  
        setContentView(R.layout.activity_main);
    	linearLayout = (LinearLayout) findViewById(R.id.layer);
		
        form = new CreditCardForm(this);
    	linearLayout.addView(form);
    	
    	buttonAuthorize = (Button) findViewById(R.id.buttonAuthorize);
    	buttonAuthorize.setOnClickListener(new OnClickListener() {
    		
    		@Override
    		public void onClick(View arg0) {
    			if(form.isCreditCardValid())
    			{
    				CreditCard card = form.getCreditCard();
    				//Pass credit card to service
    			}
    			else
    			{
    				//Alert Credit card invalid
    			}
    		}
    	});
    }

TODO

• Diner's Club is not yet implemented, although the assets and regex seem to be in place

Version History

###1/13/2017

• Added BinChangeCallback interface.

###11/11/2016

• Added CardTypeChangeCallback interface.

###9/17/2015

• Changed how the ZipCodeText is validating zip codes so it will work with other countries.
• fix for isCreditCardValid() returning true when it is not

###9/8/2015

• fix bug where isValidCard would be called many times
• allow for using colors from theme

###8/21/2015

• don't drop key strokes after backspace

###8/21/2015

• focus change behavior can now keep up with very fast typing
• several minor performance tweaks

###8/18/2015

• fix typo in hint for exp date
• fix for dates not being able to exceed 2034
• fix for current month being invalid

###7/27/2015

• fix occasional NPE

###7/15/2015

• fix for order of operations when invalidating card and calling delegate methods

###7/07/2015

• Be able to change input field's text, hint and cursor color

###5/16/2015

• use an animator to do the scroll

###5/14/2015

• don't call complete callback twice

###5/13/2015

• add setters for other CC fields
• correctly manage state such that more than one form on a screen can handle state change

###5/11/2015

• Added clearForm()

###4/27/2015

• removed a bunch of dead resources reducing aar size by ~17%

###4/26/2015

• fixed corner radius of card back
• allow setting an invalid number programmatically

###4/24/2015

• Done IME causes validation check and keyboard dismiss
• All fields except credit card # are now optional
• Allow setting credit card number programmatically

###4/21/2015

• Don't focus credit card by default. Add mechanism for clients to focus any field if desired.
• CardType now contains image drawable ids for front and back of card
• The credit card placeholder hint can now be specified via xml
• Setting focus change listener now delegates to all internal fields.
• Background of widget is now configurable

###4/20/2015

• Flip the card image back to the front after CVV field loses focus
• Expose CardType on CreditCard object
• Transferred repo ownership

###4/19/2015

• Don't scroll when scrolling is already happening

###4/18/2015

• Made helper optional (app:include_helper="false")
• Fixed a ton of lint warnings
• Fixed vertical alignment of form fields
• Fixed over excited animation scroll
• Last 4 of card now tappable to enter edit mode
• updated image assets

###4/8/2015

• Always return CreditCard object when requested even when invalid

###4/7/2015

• Made zip code optional (app:include_zip="false")
• added callback when data entry is complete and card is valid
• optionally specify helper text color in XML attrs

###5/11/2013

• Updated Demo added screenshots

###4/2/2013

• Initial Commit