sanf/iran-bank-detector

A lightweight PHP library to detect Iranian banks from card numbers.

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/sanf/iran-bank-detector

v1.0.0 2025-10-01 08:40 UTC

This package is auto-updated.

Last update: 2025-10-01 09:00:43 UTC


README

This package is designed to find Iranian bank information based on IBan Numbers and Card Prefixes. Users can input either an IBan number or a card prefix to retrieve the related bank information (such as bank name, logo, and related colors).

preview

โœจ Features

  • ๐Ÿ“‘ Identify banks by IBan Number
  • ๐Ÿ’ณ Identify banks by Card Prefix
  • โœ‚๏ธ Automatically remove the IR or ir prefix from the IBan number
  • ๐ŸŽจ Display bank logos and related color information

๐Ÿ“ฆ Installation

To install the package, use the following command:

composer require sanf/iran-bank-detector

๐Ÿงช Usage

1. Using IBan number To retrieve bank information by IBan, simply pass the IBan number to the getBankByIBanCode function. This function will automatically remove the IR or ir prefix from the IBan and return the corresponding bank.

require_once "vendor/autoload.php";
use iranBank\IranBankDetector;

$detector = new IranBankDetector();
$bank = $detector->getBankByIBanCode("IR020170000000000000000000");
print_r($bank);

2. Using Card Prefix To retrieve bank information by card prefix, simply pass the card number to the getBankByCardNumber function.

require_once "vendor/autoload.php";

use iranBank\IranBankDetector;

$detector = new IranBankDetector();
$bank = $detector->getBankByCardNumber("60637311");
print_r($bank);

๐ŸŒ CDN Support

Bank logos are served via a CDN to avoid the need for users to download or upload the files themselves. You can fetch the logos from the CDN links provided in return logo field.

๐Ÿ“ Recommended Logo Size

To ensure optimal display quality, we recommend using logos with a maximum size of 72x72 pixels.

๐Ÿ“ Issues and Suggestions

If you encounter any issues or have suggestions, please create a new Issue on the GitHub repositor

power by iran-bank-detector