mostafa-ma-saleh / editcredit

Android EditText For Credit Card Numbers

Custom EditText for entering Credit Card numbers, this EditText will also display the image of the card number type being entered (after entering the second digit). And supports adding a separator (spaces or dashes) after every four digits.
This version supports Visa, MasterCard, American Express and Discover cards.

Installation via Gradle:

Step 1. Add the JitPack repository to your root build.gradle at the end of repositories:

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}

Step 2. Add the dependency

dependencies {
  ...
  implementation 'com.github.Mostafa-MA-Saleh:EditCredit:3.0.3'
}

Changelog

v 3.0.3

• Updated the compileSdk to the latest version.
• Updated kotlin to the latest version.
• Migrated the gradle files to Kotlin DSL.

v 3.0.1

• Fixed a issue with caret sometimes moving to where it shouldn't.

v 3.0.0

• Updated the library to more follow kotlin conventions.
• Replaced some methods with kotlin standard equivalents.
• Fixed an issue wherein trying to change the separator style during runtime would sometimes crash the app.
• Added a Java example activity.
• Cleaned up the code a bit.

v 2.2.0

• Added support for Diners Club cards.
• Removed the deprecated methods and constants.
• Updated dependencies.
• Other minor improvements.

v 2.1.3

• Updated dependencies.
• Minor enhancements.

v 2.1.2

• Added instant experience to the demo app.
• Minor enhancements.

v 2.1.1

• Reduced the drawables' sizes.
• Fixed the blurry card images on some devices.
• Updated the target SDK.
• Added dark mode support to the demo app.
• Other minor enhancements.

v 2.1.0

• Fixed the card icon size on Android Pie (API 28).

v 2.0.0

• Added the ability to get the card type.
• Rewrote the library in kotlin.
• Migrated to AndroidX.

v 1.7.1

• Added support for Discover cards.

v 1.6.3

• Minor bug fixes.

v 1.6.1

• Updated the demo app to include the gravity options.
• Added the ability to change the drawable gravity.
• Deprecated setSeparator(int) and replaced it with setSeparator(Separator).
• Deprecated setDisabledCards(int) and replaced it with setDisabledCards(Card...).
• The minSDK is now 14 (because of AppCompat).

v 1.5.0

• Added support for American Express.
• Added the ability to disable cards.
• Lowered the minSDK to 9.
• Changed the demo app icon.

v 1.0.1

• Changed the package name.

v 1.0

• Initial Version.

Usage

Java

Public Methods

return	Name/Description
Card	getCardType() Returns the current card type.
String	getTextWithoutSeparator() Returns the card number without the separators.
boolean	isCardValid() Validates the entered card number.
void	setSeparator(Separator) Sets the separator style.
Separator	getSeparator() Returns the current separator style.
void	setDisabledCards(Card...) Sets the disabled cards.
void	setDrawableGravity(Gravity) Sets the location of the card drawable.
Gravity	getDrawableGravity() Returns the current location of the card drawable.

Kotlin

Public Methods

return	Name/Description
void	setDisabledCards(Card...) Sets the disabled cards.

Public Attributes

Type	Name/Description	Read Only
Card	cardType The current card type.	*
String	textWithoutSeparator The card number without the separators.	*
Boolean	isCardValid Validates the entered card number.	*
Separator	separator The current separator style.
Gravity	drawableGravity The location of the card drawable.

XML

Attributes

Name	Description	values
separator	Sets the separator style	no_separator spaces dashes
drawableGravity	Sets the the location of the card drawable	start end left right
disabledCards	Sets disabled cards this can be multiple values seperated by "|" (eg. app:disabledCards="visa|amex")	none visa mastercard amex discover diners

Example

EditCredit can be used just like a normal EditText

<mostafa.ma.saleh.gmail.com.editcredit.EditCredit
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:disabledCards="visa|amex"
        app:drawableGravity="end"
        app:separator="spaces" />

Donation

If this project helps you, and you wanna buy me a cup of coffee.

License

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.

In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to <http://unlicense.org>