> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Payment Method Metadata object

export const Bin = ({content}) => <Tooltip tip="Unique set of digits assigned to an issuing bank, which can give information about an issuer and the card issued.">
        {content}
    </Tooltip>;

### Description

The Payment Method Metadata object allows you to obtain additional information about a specific payment method used for a transaction. 

The following inputs are available, indicated by the `Type`:

* `BIN` – The <Bin content="bank identification number (BIN)" /> of a card, which is 8 or 6 digits.
* `GOOGLE_PAY` – The temporary token returned by the Google Pay API, as submitted in the `PaymentData` parameter in the Google Pay pay-in.

For card payments, Mangopay returns the `CardInfo.BIN` parameter on the following transaction objects:

* [Direct Card PayIn](/api-reference/direct-card-payins/create-direct-card-payin)
* [Recurring Card PayIn (CIT)](/api-reference/recurring-card-payins/create-recurring-payin-cit)
* [Preauthorization](/api-reference/preauthorizations/create-preauthorization)
* [Deposit Preauthorization](/api-reference/deposit-preauthorizations/create-deposit-preauthorization)
* [Card Validation](/api-reference/card-validations/create-card-validation)

The `CardInfo.BIN` is returned as an 8-digit BIN if available, otherwise 6 digits are returned.

<Check>
  **Best practice – For BIN lookup, use an 8-digit version if available**

  An 8-digit BIN provides the most detailed and accurate data for card identification and assessment, and is becoming the industry standard. The 6-digit version continues to be used but provides less granular classification that may be ambiguous if 8-digit sub-ranges have been introduced by the issuer.

  A transaction's `CardInfo.BIN` property returns the 8-digit BIN if its available. In the Card object, the `Alias` only ever reveals the first 6 digits – the 8-digit version should be preferred.
</Check>

### Attributes

<ParamField body="Type" type="string">
  **Allowed values:** `BIN`, `GOOGLE_PAY`

  The type of metadata.
</ParamField>

<ParamField body="Bin" type="string">
  Format: 6 or 8 digits

  The bank identification number (BIN).
</ParamField>

<ParamField body="Token" type="string">
  The tokenized payment data provided by the third-party payment method.
</ParamField>

<ParamField body="TokenFormat" type="string">
  **Allowed values:** `PAN_ONLY`, `CRYPTOGRAM_3DS`

  In the case of Google Pay, the format of the `Token`.

  * `PAN_ONLY` – The card is registered in the Google account and requires 3DS authentication.
  * `CRYPTOGRAM_3DS` – The card is enrolled in the customer’s Google Wallet and authentication is handled by the Android device.
</ParamField>

<ParamField body="IssuerCountryCode" type="string">
  Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats))

  The country where the card was issued.
</ParamField>

<ParamField body="IssuingBank" type="string">
  The name of the card issuer.
</ParamField>

<ParamField body="BinData" type="array">
  object

  Additional data about the card based on the BIN. In the case of <a href="/guides/payment-methods/card/co-branded">co-branded card products</a>, two objects are returned.

  <Expandable title="properties">
    <ParamField body="CardType" type="string">
      **Returned values:** `CREDIT`, `DEBIT`, `CHARGE CARD`

      The type of the card.
    </ParamField>

    <ParamField body="CommercialIndicator" type="string">
      **Returned values:** `PERSONAL`, `COMMERCIAL`

      Whether the card is held in a personal or commercial capacity.
    </ParamField>

    <ParamField body="SubType" type="string">
      The subtype of the card product. Examples include: `CLASSIC`, `GOLD`, `PLATINUM`, `PREPAID`, etc.

      **Note:** The possible returned values are numerous and liable to evolve over time.
    </ParamField>

    <ParamField body="Brand" type="string">
      The card brand. Examples include: `AMERICAN EXPRESS`, `DISCOVER`, `JCB`, `MASTERCARD`, `VISA`, etc.

      **Note:** The possible returned values are numerous and liable to evolve over time.
    </ParamField>
  </Expandable>
</ParamField>