Adyen · JSON Structure

Binlookup Card Bin Structure

CardBin schema from Adyen API

Type: object Properties: 11
PaymentsFinancial ServicesFintech

CardBin is a JSON Structure definition published by Adyen, describing 11 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

bin commercial fundingSource fundsAvailability issuerBin issuingBank issuingCountry issuingCurrency paymentMethod payoutEligible summary

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-structure/binlookup-card-bin-structure.json",
  "description": "CardBin schema from Adyen API",
  "type": "object",
  "properties": {
    "bin": {
      "description": "The first 6 digit of the card number. Enable this field via merchant account settings.",
      "type": "string"
    },
    "commercial": {
      "description": "If true, it indicates a commercial card. Enable this field via merchant account settings.",
      "type": "boolean"
    },
    "fundingSource": {
      "description": "The card funding source. Valid values are:\n* CHARGE\n* CREDIT\n* DEBIT\n* DEFERRED_DEBIT\n* PREPAID\n* PREPAID_RELOADABLE\n* PREPAID_NONRELOADABLE\n> Enable this field via merchant account settings.",
      "type": "string"
    },
    "fundsAvailability": {
      "description": "Indicates availability of funds.\n\nVisa:\n* \"I\" (fast funds are supported)\n* \"N\" (otherwise)\n\nMastercard:\n* \"I\" (product type is Prepaid or Debit, or issuing country is in CEE/HGEM list)\n* \"N\" (otherwise)\n> Returned when you verify a card BIN or estimate costs, and only if `payoutEligible` is different from \"N\" or \"U\".",
      "type": "string"
    },
    "issuerBin": {
      "x-addedInVersion": "54",
      "description": "The first 8 digit of the card number. Enable this field via merchant account settings.",
      "type": "string"
    },
    "issuingBank": {
      "description": "The issuing bank of the card.",
      "type": "string"
    },
    "issuingCountry": {
      "description": "The country where the card was issued from.",
      "type": "string"
    },
    "issuingCurrency": {
      "description": "The currency of the card.",
      "type": "string"
    },
    "paymentMethod": {
      "description": "The payment method associated with the card (e.g. visa, mc, or amex).",
      "type": "string"
    },
    "payoutEligible": {
      "description": "Indicates whether a payout is eligible or not for this card.\n\nVisa:\n* \"Y\"\n* \"N\"\n\nMastercard:\n* \"Y\" (domestic and cross-border)\n* \"D\" (only domestic)\n* \"N\" (no MoneySend)\n* \"U\" (unknown)\n> Returned when you verify a card BIN or estimate costs, and only if `payoutEligible` is different from \"N\" or \"U\".",
      "type": "string"
    },
    "summary": {
      "description": "The last four digits of the card number.",
      "type": "string"
    }
  },
  "name": "CardBin"
}