Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.orchestrasolutions.com/llms.txt

Use this file to discover all available pages before exploring further.

The Brand Lookup endpoint identifies the card brand (Visa, Mastercard, American Express, etc.) from the card’s BIN/IIN and returns a URL to the brand’s logo image. Endpoint: GET /Tools/brand

​
When to Use This

Use Brand Lookup when you need to display the card brand logo in your payment form as the customer types their card number. After the customer enters the first 6 digits, you can call this endpoint to identify the brand and show the corresponding logo — giving the customer immediate visual feedback that their card is recognized. This is lighter than the full Metadata Lookup since it only returns the brand name and logo URL.

​
How It Works

Pass the first 6 to 11 digits of the card number as the iin query parameter. The endpoint returns the identified brand and a URL to the brand’s logo.
ParameterTypeRequiredDescription
iinstring (query)YesThe first 6 to 11 digits of the card number

​
Example: Show Brand Logo During Card Entry

Call the endpoint once the customer has entered at least 6 digits, then display the logo next to the card number field. 
const cardInput = document.getElementById('card-number');

cardInput.addEventListener('input', async (e) => {
  const digits = e.target.value.replace(/\D/g, '');

  if (digits.length >= 6) {
    const response = await fetch(
      `https://api.orchestrasolutions.com/Tools/brand?iin=${digits.substring(0, 8)}`,
      { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
    );

    if (response.ok) {
      const { brand, brandLogoUrl } = await response.json();
      document.getElementById('brand-logo').src = brandLogoUrl;
      document.getElementById('brand-logo').alt = brand;
    }
  }
});

Metadata Lookup

Need more than just the brand? Get full card metadata.

API Reference

Full endpoint specification and response schema