Skip to main content

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.

​
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 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: The CardInfo.BIN is returned as an 8-digit BIN if available, otherwise 6 digits are returned.
Best practice – For BIN lookup, use an 8-digit version if availableAn 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.

​
Attributes

​
Type
string
Allowed values: BIN, GOOGLE_PAYThe type of metadata.
​
Bin
string
Format: 6 or 8 digitsThe bank identification number (BIN).
​
Token
string
The tokenized payment data provided by the third-party payment method.
​
TokenFormat
string
Allowed values: PAN_ONLY, CRYPTOGRAM_3DSIn 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.
​
IssuerCountryCode
string
Format: Two-letter country code (ISO 3166-1 alpha-2 format)The country where the card was issued.
​
IssuingBank
string
The name of the card issuer.
​
BinData
array
objectAdditional data about the card based on the BIN. In the case of co-branded card products, two objects are returned.