https://github.com/lfaoro/creditcard
Credit Card structure, helpers and validation.
https://github.com/lfaoro/creditcard
creditcard go golang luhn-algorithm maxmind package
Last synced: 8 months ago
JSON representation
Credit Card structure, helpers and validation.
- Host: GitHub
- URL: https://github.com/lfaoro/creditcard
- Owner: lfaoro
- License: mit
- Created: 2018-06-13T09:32:39.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-06-20T11:46:58.000Z (almost 8 years ago)
- Last Synced: 2025-02-01T14:23:58.264Z (about 1 year ago)
- Topics: creditcard, go, golang, luhn-algorithm, maxmind, package
- Language: Go
- Homepage:
- Size: 51.8 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Credit Card
It implements various checks on a credit card details and reduces human
error using the Luhn algorithm.
Offers various helpers for data manipulation.
Does risk evaluation using maxMind's minFraud service.
[](LICENSE)
[](https://godoc.org/github.com/lfaoro/creditcard)
[](https://goreportcard.com/report/github.com/lfaoro/creditcard)
## Installation
```bash
go get github.com/lfaoro/creditcard
```
## Quick start
```go
// Create a new CreditCard instance.
card := creditcard.New("Leonardo Faoro", "4444333322221111", "123", "06/2019")
// Create a new CreditCard instance and validate it
// using all the checks implemented so far.
card, err := creditcard.NewValidate("Leonardo Faoro", "4444333322221111", "123", "06/2019")
if err != nil {
log.Fatal(err)
}
// Validate a CreditCard using all the checks implemented so far.
if err := card.Validate(); err != nil {
log.Fatal(err)
}
// Luhn checksum a number. https://en.wikipedia.org/wiki/Luhn_algorithm
if yes := creditcard.Luhn("4444333322221111"); !yes {
log.Println("Luhn validation failed.")
}
// Encrypt the CreditCard.Number and get the bytes blob.
b := card.Encrypt("mySuperSecureSalt")
// Common helpers.
fmt.Println(card.First6()) // 123456
fmt.Println(card.Last4()) // 4567
fmt.Println(card.Issuer()) // other, visa, amex, ...
fmt.Println(card.ToJSON()) // {"name":"Leonardo Faoro","number":"4444333322221111","cvv_2":"123","expiry":"06/2019"}
```
## Maxmind's minFraud (https://www.maxmind.com/en/minfraud-services)
minFraud uses a combination of data points across over a billion transactions to provide an accurate risk score for every credit or debit card payment you process. Several variables go into the assessment and scoring, including geolocation, IIN information, reputation checks, IP checks, and device tracking.
### Benefits
- Significantly reduce or eliminate the number of fraudulent transactions your business processes.
- Significantly reduce or eliminate chargebacks from customers (e.g. if they have been the victim of identity theft and their card has been used in a criminal way).
### Quick start
```bash
export MAXMIND_USER="123456"
export MAXMIND_PASSWORD="maxMindServicePassword"
export MAXMIND_ENDPOINT="https://minfraud.maxmind.com/minfraud/v2.0/insights"
# NB: alternatively provide a .env file in your app with the above variables.
```
```go
riskScore, err := maxmind.RiskCheck(card.First6(), card.Last4(), "8.8.8.8", "test@test.com")
if err != nil {
log.Println("riskCheck error: ", err)
}
fmt.Println(riskScore)
```
# Contibuting
> Any help and suggestions are very welcome and appreciated.