Metadata Lookup

async function selectGateway(cardNumber, apiKey) {
  const iin = cardNumber.replace(/\D/g, '').substring(0, 8);

  const response = await fetch(
    `https://api.orchestrasolutions.com/Tools/iin?iin=${iin}`,
    { headers: { 'X-Api-Key': apiKey } }
  );
  const { countryCode, cardBrand } = await response.json();

  // Route Moroccan cards to a local PSP for better approval rates
  if (countryCode === 'MA') {
    return 'payzone-morocco';
  }

  // Route Amex through a gateway with better Amex rates
  if (cardBrand === 'AMERICAN EXPRESS') {
    return 'amex-preferred-gateway';
  }

  return 'stripe-default';
}

import requests

def select_gateway(card_number, api_key):
    """Choose the best PSP based on card metadata."""
    iin = card_number.replace(' ', '')[:8]

    response = requests.get(
        'https://api.orchestrasolutions.com/Tools/iin',
        params={'iin': iin},
        headers={'X-Api-Key': api_key}
    )
    response.raise_for_status()
    meta = response.json()

    if meta['countryCode'] == 'MA':
        return 'payzone-morocco'

    if meta['cardBrand'] == 'AMERICAN EXPRESS':
        return 'amex-preferred-gateway'

    return 'stripe-default'

curl "https://api.orchestrasolutions.com/Tools/iin?iin=411111" \
  -H "X-Api-Key: YOUR_API_KEY"

# Response:
# {
#   "bin": "411111",
#   "cardBrand": "VISA",
#   "cardType": "CREDIT",
#   "category": "CLASSIC",
#   "issuingOrganization": "JPMORGAN CHASE BANK, N.A.",
#   "countryCode": "US",
#   "brandLogoUrl": "https://..."
# }