Download the PHP package ibanchecker/client without Composer
On this page you can find all versions of the php package ibanchecker/client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ibanchecker/client
More information about ibanchecker/client
Files in ibanchecker/client
Package client
Short Description Official PHP client for the ibanchecker.cash IBAN validation API: validate IBANs across 92 countries, extract IBANs from text, and look up SWIFT/BIC codes.
License MIT
Homepage https://ibanchecker.cash
Informations about the package client
ibanchecker/client
Official PHP client for the ibanchecker.cash IBAN validation API.
Validate IBANs across 92 countries, validate up to 100 IBANs per request, extract IBANs from free text, look up country format specifications, and resolve SWIFT/BIC codes. No IBAN data is stored or logged; all validation runs in memory at the edge.
Install
Requires PHP 8.0 or newer with ext-curl and ext-json. There are no Composer dependencies.
Quick start
Authentication
An API key is optional. Without one, requests are limited to 100 per hour per IP. With a key, requests count against your plan quota. Get a free key at ibanchecker.cash/api-docs.
Methods
| Method | Description |
|---|---|
validate(string $iban) |
Validate a single IBAN. Returns a ValidationResult. |
validateBulk(iterable $ibans) |
Validate up to 100 IBANs. Returns a BatchResult. |
extract(string $text) |
Find and validate IBANs in free text (up to 50,000 chars). Returns a BatchResult. |
getFormat(string $country) |
IBAN format spec for an ISO country code. Returns a FormatSpec. |
lookupBic(string $bic) |
Resolve an 8 or 11 character BIC. Returns a BankRecord. |
Bulk validation
Extract from text
Country format and BIC lookup
The national check digit
For a number of countries the API also runs the national account check digit on top of the ISO 13616 check, and reports it on nationalCheckValid. It is advisory: an IBAN with valid = true is a valid IBAN whatever this says. A false usually means a transcription error in the account number. It is null where the country has no such scheme.
Error handling
A malformed IBAN is not an exception: validate() returns a ValidationResult with valid = false. Exceptions are raised only for transport, authentication, quota and server-side problems.
Every exception extends IbanChecker\Exception\IbanCheckerException and carries getStatus(), getErrorCode() and getResponse().
Using your own HTTP stack
The client ships a cURL transport and needs nothing installed. If your application already has an HTTP layer, implement IbanChecker\Transport and pass it in. This is also how the test suite runs without a network.
Raw responses
Every model keeps the untouched response body on ->raw, so a field added to the API later is reachable without waiting for a client release.
Tests
Links
- Website: https://ibanchecker.cash
- API documentation: https://ibanchecker.cash/api-docs
- OpenAPI spec: https://ibanchecker.cash/openapi.json
- Free online tools: https://ibanchecker.cash/tools
License
MIT
All versions of client with dependencies
ext-curl Version *
ext-json Version *