Bankové identifikátory

Bankové hodnotové objekty sú nezávislé od frameworku a použiteľné samostatne — v platobných payloadoch, formulároch aj vlastných modeloch:

use RoundlyConsulting\Qr\Banking\{Bic, CreditorReference, Iban};

$iban = Iban::fromString('SK46 1100 0000 0029 4714 7960');
$iban->formatted();        // "SK46 1100 0000 0029 4714 7960"
$iban->electronic();       // "SK4611000000002947147960"
$iban->isEea();            // true
Iban::isValid('DE00 1234');  // false (no exception)

Bic::fromString('TATRSKBX')->country();           // "SK"
CreditorReference::generate('539007547034');       // RF18539007547034
CreditorReference::fromString('RF18 5390 0754 7034')->electronic();

• Iban — fromString() odstráni medzery, NBSP a pomlčky a prevedie na veľké písmená; ďalej isValid(), country(), checkDigits(), bban(), electronic(), formatted(), isEea(), equals().
• Bic — fromString(), isValid(), institution(), country(), location(), branch(), isTestCode(), value().
• CreditorReference — fromString(), generate($reference), isValid(), electronic(), formatted().

Validácia IBAN prebieha v poradí štruktúra → známa krajina → presná dĺžka → štruktúra BBAN → MOD 97-10, podľa 103 záznamov registra SWIFT IBAN. Chyby vyhodia InvalidIbanException, InvalidBicException alebo InvalidCreditorReferenceException s presným dôvodom (iban_checksum, bic_country, creditor_reference_format, …).