Mimir  

What is Mimir ?

Mimir is a lightweight library that exposes some functions to validate banking informations.
It does not store any of your personal data, you can use it freely.

Disclaimer

This library is still in development, so it might be possible that some methods change over time.

Methods available

If you experienced troubles with one of our methods, don't hesitate telling us by submitting an issue.

Bank account numbers

IBAN Methods

| Method Name | Short Description | | ----------- | ----------------- | | IsIBANValid | Validate an IBAN | | GetIBANCheckDigits | Compute or fix check digits from an IBAN | | FormatIBAN | Format IBAN based on its structure | | PrintFormatIBAN | Format IBAN as it would be printed | | GetCountryConfiguration | Get country configuration and informations | | SplitIBAN | Split the IBAN based on its structure |

ABA Routing Number Methods

| Method Name | Short Description | | ----------- | ----------------- | | IsABARTNValid | Validate an ABA | | GetABARTNCheckDigit | Compute or fix check digits for an ABA | | SplitABARTN | Split the ABA based on its structure |

Supported countries

Please visit SUPPORTED_COUNTRIES.md

Payment card numbers

All cards in the examples has been generated randomly

Methods

| Method Name | Short Description | | ----------- | ----------------- | | MatchPaymentCard | Validate a payment card number from a specific card issuer or not | | GetPaymentCardCheckDigits | Compute or fix check digits from a payment card | | GetPaymentCardConfiguration | Get payment cards information from an issuer | | FormatPaymentCard | Format payment card based on its structure |

Supported cards

Please visit SUPPORTED_CARDS.md

Usage

Get / Install

$ go get -u github.com/vdlbk/mimir

Examples

Validate an IBAN

package main

import (
	"fmt"
	"github.com/vdlbk/mimir"
)

func main(){
	IBAN := "FR1420041010050500013M02606"
	
	err := mimir.IsIBANValid(IBAN)
	fmt.Println(err) // nil
	
	badIBAN := "FR1420041010050500013M02605"
	
	err = mimir.IsIBANValid(badIBAN)
	fmt.Println(err) // IBAN invalid checksum
}

Validate a payment card number

package main

import (
	"fmt"
	"github.com/vdlbk/mimir"
)

func main(){
	number := "345752218692713"
	
	r, err := mimir.MatchPaymentCard(number, mimir.AmericanExpress)
	fmt.Println(r, err) // [American Express], nil
	
	badNumber := "foobar"
	
	r, err = mimir.MatchPaymentCard(badNumber, mimir.AmericanExpress)
	fmt.Println(r, err) // nil, Payment card does not match any issuer
}