v2

latestOpenAPI 3.1.02026-07-262279731.3 MB
paymentMethodMetadata

Look up metadata for a payment method

<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>

post/v2.01/{ClientId}/payment-methods/metadata

Path parameters

ClientIdstring required

Platform's API account identifier, associated with the API key.

Headers

Authorizationstring required

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Request body

Typestring required

Allowed values: BIN, GOOGLE_PAY

The type of metadata.

Binstring

Format: 6 or 8 digits

Required if the Type is BIN. The bank identification number (BIN).

Tokenstring

Required if the Type is GOOGLE_PAY.

The tokenized payment data provided by the third-party payment method.

Response

Success

Typestring

The type of metadata.

Binstring

Format: 6 or 8 digits

The bank identification number (BIN).

IssuerCountryCodestring

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country where the card was issued.

IssuingBankstring

The name of the card issuer.

TokenFormatstring

Returned 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.