Saved Dealer Validation

<head>
  <!-- AWS WAF Challenge Script (Required for security) -->
  <script type="text/javascript" 
    src="https://eb9c20d17a28.us-east-2.captcha-sdk.awswaf.com/eb9c20d17a28/jsapi.js" 
    data-awswaf-challenge-compact="true" 
    defer>
  </script>
  
  <!-- MasterFFL Select API SDK -->
  <script src="https://libs.masterffl.com/ffl-select/select-api-sdk/23.0.3/ffl-select-api-sdk.js"></script>
</head>

FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  fflLicenseNumber,
  orderCharacteristics,
  options,
  returnFullRecord
)

{
  acceptsNFAItems: true,                    // Include only if order contains NFA items (suppressors, SBRs, etc.)
  acceptsTransfersFromNonFFLSellers: true,  // Include only if seller is non-FFL (multi-vendor marketplace)
  acceptsAmmoTransfers: true,               // Reserved — not yet active
  buyersFFLLicenseNumber: string            // Optional - buyer's FFL license for B2B scenarios
}

{
  checkEmailAddressAvailable: true,     // Optional: Fails if dealer has no email on file (defaults to false)
  checkFFLLicenseFileAvailable: true,   // Optional: Fails if dealer's FFL certificate is not on file (defaults to false)
    checkSOTLicenseFileAvailable: true    // Optional: Fails if dealer's SOT file is not on file (defaults to false),
masterFFLTransferPIN: "123456" // Optional: Use the PIN to validate dealer, if dealer is opted out.

}

// Validates license format, dealer existence, closed status, and blacklist only
const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  null  // or {} or undefined
);

const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  { acceptsNFAItems: true },
  {},
  true
);

const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  { acceptsTransfersFromNonFFLSellers: true },
  {},
  true
);

const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  {
    acceptsNFAItems: true,
    acceptsTransfersFromNonFFLSellers: true
  },
  {},
  true
);

// Opt-Out Global check is skipped when buyer's license matches the saved dealer
const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  { buyersFFLLicenseNumber: '58401521' }  // Same as saved dealer — B2B scenario
);

const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  { acceptsNFAItems: true },
  {
    checkEmailAddressAvailable: true,
    checkFFLLicenseFileAvailable: true,
    checkSOTLicenseFileAvailable: true
  },
  true
);

{
  dealerPasses: boolean,        // true if all validations pass, false otherwise
  dealerRecord: object | null,  // full dealer record (only populated if returnFullRecord=true)
  reason: {                     // only present when dealerPasses=false
    code: string,               // machine-readable error code
    message: string             // display-ready message, safe to show directly to users
  }
}

{
  dealerPasses: true,
  dealerRecord: {
    id: "58401521",
    fflLicenseNumber: "5-84-123-01-6E-01521",
    tradeName: "ADAMSON POLICE PRODUCTS",
    phoneNumber: "3038334661",
    agreedToAcceptTransfer: true,
    agreedToAcceptTransfersFromNonFFLSellers: true,
    isPermanentlyClosed: false,
    isTemporarilyClosed: false,
    isBlacklisted: false,
    hasEmails: true,
    hasValidFFLCertificateOnFile: true,
    premiseAddress: {
      street: "3763 IMPERIAL STREET UNIT A",
      city: "FREDERICK",
      state: "CO",
      zipCode: "80516"
    },
    sotInformation: {
      isSotDealer: true,
      hasValidSOTFile: false
    },
    licenseExpiry: "02/01/2027",
    preferredLicenseNumber: "58401521",
    preferredLicenseExpiry: "02/01/2027",
    isPreferredSameAsGivenLicense: true,
    hasCompatibleSOT: true,
    masterFFLTransferPINEnabled: flase,
    isNFAPreferred: true
  },
  reason: null
}

{
  dealerPasses: false,
  dealerRecord: null,  // or partial dealer data if returnFullRecord=true
  reason: {
    code: "PERMANENTLY_CLOSED",
    message: "This dealer is permanently closed and cannot accept transfers."
  }
}

const result = await FFLSelectAPISDK.verifySavedDealerOrderAcceptance(
  '58401521',
  { acceptsTransfersFromNonFFLSellers: true }
);

if (!result.dealerPasses) {
  console.log('Error Code:', result.reason.code);
  console.log('Error Message:', result.reason.message); // safe to display to user
}