Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/orazz/CreditCardForm-iOS

CreditCardForm is iOS framework that allows developers to create the UI which replicates an actual Credit Card.
https://github.com/orazz/CreditCardForm-iOS

credit-card creditcardform ios-swift stripe

Last synced: about 2 months ago
JSON representation

CreditCardForm is iOS framework that allows developers to create the UI which replicates an actual Credit Card.

Lists

README 

        
# CreditCardForm



[![CI Status](https://travis-ci.org/orazz/CreditCardForm-iOS.svg?branch=master)](https://travis-ci.org/orazz/CreditCardForm-iOS)

CocoaPods compatible

[![Carthage compatible](https://img.shields.io/badge/Carthage-Compatible-brightgreen.svg?style=flat)](https://github.com/Carthage/Carthage)

Swift 4.2 compatible

Platform iOS

License: MIT

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GSV5DLQRJ5AH2&lc=US&item_name=Oraz%20Atakishiyev&item_number=PageMenu&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted)



CreditCardForm is iOS framework that allows developers to create the UI which replicates an actual Credit Card.



Fixed typo use CreditCardForm instead ~~CreditCardForum~~



### Screenshots

 



## Example



To run the example project, clone the repo, and run `pod install` from the Demo-\* directory first.



## Supported Cards



- [x] MasterCard

- [x] Visa

- [x] JCB

- [x] Diners

- [x] Discover

- [x] Amex

- [x] UnionPay



## Requirements



* Xcode 8

* iOS 8.1+



## Installation



#### Using [CocoaPods](http://cocoapods.org)



CreditCardForm is available through CocoaPods. To install it, simply add the following line to your `Podfile`:



```ruby

pod "CreditCardForm"

```



#### Using [Carthage](https://github.com/Carthage/Carthage)



CreditCardForm is available through Carthage. To install it, simply add the following line to your `Cartfile`:



```ruby

github "orazz/CreditCardForm-iOS"

```



#### Manually



If you prefer not to use either of the aforementioned dependency managers, you can integrate CreditCardForm into your project manually.



1. Download and drop ```CreditCardForm``` in your project.  

2. Done!  



## Usage example



First step: this framework integrated with Stripe, you must install [Stripe](https://stripe.com/docs/mobile/ios)



#### Storyboard

Create a view set a class CreditCardFormView (preferred frame size: 300x200). 
 

Following this you will have to go through a few simple steps outlined below in order to get everything up and running.

``` swift

import Stripe

import CreditCardForm

```

#### Swift

``` swift

@IBOutlet weak var creditCardForm: CreditCardFormView!



// Stripe textField

let paymentTextField = STPPaymentCardTextField()

```



#### Add the following code in the viewDidLoad function in your view controller



```swift

// Set up stripe textfield

paymentTextField.frame = CGRect(x: 15, y: 199, width: self.view.frame.size.width - 30, height: 44)

paymentTextField.translatesAutoresizingMaskIntoConstraints = false

paymentTextField.borderWidth = 0



let border = CALayer()

let width = CGFloat(1.0)

border.borderColor = UIColor.darkGray.cgColor

border.frame = CGRect(x: 0, y: paymentTextField.frame.size.height - width, width:  paymentTextField.frame.size.width, height: paymentTextField.frame.size.height)

border.borderWidth = width

paymentTextField.layer.addSublayer(border)

paymentTextField.layer.masksToBounds = true



view.addSubview(paymentTextField)



NSLayoutConstraint.activate([

paymentTextField.topAnchor.constraint(equalTo: creditCardForm.bottomAnchor, constant: 20),

paymentTextField.centerXAnchor.constraint(equalTo: view.centerXAnchor),

paymentTextField.widthAnchor.constraint(equalToConstant: self.view.frame.size.width-20),

paymentTextField.heightAnchor.constraint(equalToConstant: 44)

])

```



#### Delegate Methods



In order to use the delegate methods first set the delegate of Stripe to the parent view controller when setting it up



``` swift

paymentTextField.delegate = self

```



After that you will be able to set up the following delegate methods inside of your parent view controller



``` swift

func paymentCardTextFieldDidChange(_ textField: STPPaymentCardTextField) {

creditCardForm.paymentCardTextFieldDidChange(cardNumber: textField.cardNumber, expirationYear: textField.expirationYear, expirationMonth: textField.expirationMonth, cvc: textField.cvc)

}



func paymentCardTextFieldDidEndEditingExpiration(_ textField: STPPaymentCardTextField) {

creditCardForm.paymentCardTextFieldDidEndEditingExpiration(expirationYear: textField.expirationYear)

}



func paymentCardTextFieldDidBeginEditingCVC(_ textField: STPPaymentCardTextField) {

creditCardForm.paymentCardTextFieldDidBeginEditingCVC()

}



func paymentCardTextFieldDidEndEditingCVC(_ textField: STPPaymentCardTextField) {

creditCardForm.paymentCardTextFieldDidEndEditingCVC()

}

```



**You should now be ready to use CreditCardForm!!**



## Customization



**1) Colors**

``` swift

creditCardForm.backgroundColor (UIColor)

creditCardForm.cardHolderExpireDateColor (UIColor)

creditCardForm.cardHolderExpireDateTextColor (UIColor)

creditCardForm.backLineColor (UIColor)



// Brands Color brand name, front color, back color

[String: [UIColor]]



creditCardForm.cardGradientColors[Brands.Visa.rawValue] = [UIColor.blue, UIColor.red]



// Set font

creditCardForm.cardNumberFont = UIFont(name: "FontName", size: 20)!

creditCardForm.cardPlaceholdersFont = UIFont(name: "FontName", size: 10)!

creditCardForm.cardTextFont = UIFont(name: "FontName", size: 12)!

```

**2) Images**

``` swift

creditCardForm.chipImage (UIImage)

```

**3) Placeholders**

``` swift

creditCardForm.cardHolderString (String)

creditCardForm.expireDatePlaceholderText (String)

```

**Card number: [Configuring the Mask Field](https://github.com/artemkrachulov/AKMaskField#configuring-the-mask-field)**

``` swift

creditCardForm.cardNumberMaskExpression (String)

creditCardForm.cardNumberMaskTemplate (String)



creditCardForm.cardNumberFontSize (CGFloat)

```    

## Contribute



We would love for you to contribute to **CreditCardForm**, check the ``LICENSE`` file for more info.



## Meta



[Oraz Atakishiyev](https://github.com/orazz), [orazz.com](https://orazz.com)



#### 3rd party libraries



[CreditCardValidator](https://github.com/vitkuzmenko/CreditCardValidator) 


[AKMaskField](https://github.com/artemkrachulov/AKMaskField)



## License



CreditCardForm is available under the MIT license. See the LICENSE file for more info.