FAQ
G'day! Here are some of the most frequently asked questions but if you have other questions not covered here, please send us an email.
To apply different surcharges, you can use our API to determine the card type by submitting the first 6 to 8 digits. It's important to avoid repeated queries for the same card number during customer input and to make the API call after the 6th digit is entered. For front-end implementations, use the 'input' event listener to accommodate paste actions or browser autofill, which may not trigger keypress events.
The x-api-key header must always be included in your request (some early access users had a different referer based setup and we have done a configuration for those accounts not impact their services). Having an account serves a key role in enabling us to provide you with targeted support. If you encounter any issues or require assistance, the aki key allows us to quickly locate your requests and understand the context, significantly speeding up our ability to diagnose and resolve any problems.
We understand that changes to the API request or response structure can be disruptive, which is why we're committed to keeping such modifications to a minimum, if not zero. It's unlikely we'll change these aspects of our service without extraordinary reason. However, in the rare event of an outage or if we introduce a new, upgraded service, we want to keep you informed.
Our API is at the forefront of this change, supporting both 6-digit and 8-digit BINs. This means you can rely on our API for up-to-date, accurate identification of card issuers and types, whether your systems are currently using the traditional 6-digit BINs or have transitioned to the newer 8-digit format.
Despite its classification, the security of the BIN is paramount. Its critical role in the financial ecosystem necessitates stringent protection, especially when processed or transmitted with other payment card data. Our API is crafted to maintain the highest levels of data protection and security, treating BINs with diligence equivalent to that of more sensitive information. This strategy ensures that our management of BINs complies with and often surpasses established privacy and security standards, aligning with industry-leading practices and compliance mandates.
As a reminder, for the use of the BIN API, make sure to only submit up to the first 8 digits of the card number (in most cases, you just need first 6). Full card numbers or any other sensitive details should never be transmitted, ensuring adherence to security best practices and safeguarding against unauthorized access or breaches.
Our Fair Use Policy ensures that all users, especially those benefiting from our generous free limits, use the API in good faith and responsibly. This helps maintain a high-quality, reliable service for everyone without disruptions caused by excessive or abusive usage.
While our plans offer generous limits with a main focus on genuine use, certain activities — such as systematic scraping, bulk data extraction, reselling, or rebranding our API data — are strictly prohibited. We also have advanced detection systems in place to prevent abuse.
Over the past two years, our free plan has been the most targeted for abuse, leading us to implement robust safeguards to maintain its availability and integrity.
Our premium plans were introduced in response to overwhelming demand from businesses seeking higher, guaranteed usage quotas. These plans are priced at a minimal cost to help cover server expenses while keeping our API accessible and fair for all users.
For full details on permitted and restricted uses, please see our Fair Use Policy.