Ecosyste.ms: Awesome

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

https://github.com/yassram/YRPayment

Better payment user experience library with cool animation in Swift
https://github.com/yassram/YRPayment

animation credit-card payment swift ui

Last synced: about 2 months ago
JSON representation

Better payment user experience library with cool animation in Swift

Lists

README 

        


  Twitter Follow

  

  

    Carthage

  

    

    Carthage

  

  

  











## 🎬 Preview








## 🌟 Features

- [x] Easily usable

- [x] Simple Swift syntax

- [x] Cool flip animation

- [x] Compatible with `Carthage`

- [x] Compatible with `CocoaPods`

- [x] Customizable

- [x] Universal (iPhone & iPad)

- [x] Lightweight readable codebase

- [x] And More...



## 📲 Installation



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



Edit your `Podfile` and specify the dependency:



```ruby

pod "YRPayment"

```



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



Edit your `Cartfile` and specify the dependency:



```bash

github "yassram/YRPayment"

```



## 🐒 How to use



In **4** steps:



**1.** Import YRPayment.

```swift

import YRPayment

```



**2.** Create a YRPaymentCreditCard instance and link it to a YRPayement instances:

```swift

let card = YRPaymentCreditCard()

let payment = YRPayment(creditCard: card)

```



**3.** Add your card to a view and set its position: 

```swift

view.addSubview(card)

card.centerXAnchor.constraint(equalTo: view.centerXAnchor).isActive = true

card.centerYAnchor.constraint(equalTo: view.centerYAnchor).isActive = true

```

**4.** link your textFields to the payment object: 

```swift

payment.numberTextField = NumberTF

payment.holderNameTextField = NameTF

payment.validityTextField = ValidityTF

payment.cryptogramTextField = cryptoTF

```

> *(Assuming that NumberTF, NameTF, ValidityTF, cryptoTF are textField alrready created)*



**5.** Enjoooooooy ! 








## 🔍 Extracting data from the credit card



To extract data from the credit card :



1. Credit card number :

```swift

payment.getCardNumber()

```



2. Credit card holder name :

```swift

payment.getCardHolderName()

```



3. Credit card validity :

```swift

payment.getCardValidity()

```



4. Credit card cryptogram

```swift

payment.getCardCryptogram()

```



## 🎨 Customization : (more features are coming soon)



### 💳 Customizing the credit card type (Symbole):



When creating your creditCard instance (as seen before 👆) MasterCard is default:

```swift

let card = YRPaymentCreditCard()

```

you can specify the symbole you want from the available types:

```swift

let card = YRPaymentCreditCard(type: .masterCard)

```

or specify a custom one by uploading your own image symbole:

```swift

let image = UIImage(named: "mySymboleImage")!

let card = YRPaymentCreditCard(type: .custom(image))

```



  

  




> **More types are coming soon**

### 🕹 Enable/Disable flip on user tap:

```swift

// Enable

payment.flipOnClick = true



// Disable

payment.flipOnClick = false

```



## 🙏 Contributing

This is an open source project, so feel free to contribute. How?

- Open an  issue.

- Send feedback via email.

- Propose your own fixes, suggestions and open a pull request with the changes.



## 📢 Mentions

- https://www.cocoacontrols.com/controls/better-payment-user-experience-library-with-cool-animation-in-swift

- https://github.com/vsouza/awesome-ios



Did you mention `YRPayment` in your website, do you use it in your app ? send me a message to be added in this section!











## 💻 Author



* Yassir Ramdani



## 📝 License



```

MIT License



Copyright (c) 2019 yassir RAMDANI



Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:



The above copyright notice and this permission notice shall be included in all

copies or substantial portions of the Software.



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 OR COPYRIGHT HOLDERS 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.



```